truehear-audio-library-node 1.0.0

package/include/ipolicy_config.h

@@ -0,0 +1,420 @@
+#ifndef TRUEHEAR_IPOLICY_CONFIG_H
+#define TRUEHEAR_IPOLICY_CONFIG_H
+
+#include <windows.h>
+#include <mmdeviceapi.h>
+#include <audioclient.h>
+#include <propidl.h>
+
+/*
+ * Undocumented Windows PolicyConfig COM interfaces.
+ *
+ * Windows does not provide an official public header for these interfaces,
+ * but they are commonly used to change the default audio endpoint.
+ *
+ * This header manually describes the COM vtable layout so we can call methods
+ * directly through the vtable:
+ *
+ *   policy_config->lpVtbl->SetDefaultEndpoint(
+ *       policy_config,
+ *       device_id,
+ *       eConsole
+ *   );
+ *
+ * Important:
+ * - The method order in the vtable matters.
+ * - COM uses the vtable index to find the function.
+ * - Do not reorder methods unless you are intentionally changing the interface.
+ *
+ * GUIDs are only declared here as extern.
+ * They must be defined in exactly one .c file, for example:
+ *
+ *   src/policy_config_guids.c
+ */
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/* ---------------------------------------------------------------------------------------------- */
+/* GUID declarations                                                                              */
+/* ---------------------------------------------------------------------------------------------- */
+
+/*
+ * Modern IPolicyConfig interface ID.
+ *
+ * Used with CoCreateInstance together with CLSID_CPolicyConfigClient.
+ */
+extern const IID IID_IPolicyConfig;
+
+/*
+ * Modern PolicyConfig COM class ID.
+ *
+ * Used to create the COM object:
+ *
+ *   CoCreateInstance(
+ *       &CLSID_CPolicyConfigClient,
+ *       NULL,
+ *       CLSCTX_ALL,
+ *       &IID_IPolicyConfig,
+ *       (void **)&policy_config
+ *   );
+ */
+extern const CLSID CLSID_CPolicyConfigClient;
+
+/*
+ * Older Vista-era interface ID.
+ *
+ * Kept separately because the Vista vtable layout is not identical to the
+ * modern IPolicyConfig layout.
+ */
+extern const IID IID_IPolicyConfigVista;
+
+/*
+ * Older Vista-era PolicyConfig COM class ID.
+ */
+extern const CLSID CLSID_CPolicyConfigVistaClient;
+
+/* ---------------------------------------------------------------------------------------------- */
+/* Forward declarations                                                                             */
+/* ---------------------------------------------------------------------------------------------- */
+
+/*
+ * DeviceShareMode is part of the PolicyConfig interface.
+ *
+ * For now, we only need it as a pointer type in the vtable, so a forward
+ * declaration is enough.
+ */
+typedef struct DeviceShareMode DeviceShareMode;
+
+/*
+ * Modern PolicyConfig interface.
+ */
+typedef struct IPolicyConfig IPolicyConfig;
+typedef struct IPolicyConfigVtbl IPolicyConfigVtbl;
+
+/*
+ * Vista-era PolicyConfig interface.
+ */
+typedef struct IPolicyConfigVista IPolicyConfigVista;
+typedef struct IPolicyConfigVistaVtbl IPolicyConfigVistaVtbl;
+
+/* ---------------------------------------------------------------------------------------------- */
+/* IPolicyConfig                                                                                    */
+/* ---------------------------------------------------------------------------------------------- */
+
+/*
+ * COM object layout.
+ *
+ * A COM object begins with a pointer to a vtable.
+ *
+ * We keep the traditional COM field name `lpVtbl`.
+ * That means calls look like:
+ *
+ *   policy_config->lpVtbl->MethodName(policy_config, ...);
+ */
+struct IPolicyConfig {
+  const IPolicyConfigVtbl *lpVtbl;
+};
+
+/*
+ * Vtable for the modern IPolicyConfig interface.
+ *
+ * The first three methods are the standard IUnknown methods:
+ *
+ *   QueryInterface
+ *   AddRef
+ *   Release
+ *
+ * The later methods are PolicyConfig-specific methods.
+ */
+struct IPolicyConfigVtbl {
+  /*
+   * Ask the COM object for another interface.
+   */
+  HRESULT(STDMETHODCALLTYPE *QueryInterface)(
+      IPolicyConfig *This,
+      REFIID riid,
+      void **ppvObject);
+
+  /*
+   * Increase the COM reference count.
+   */
+  ULONG(STDMETHODCALLTYPE *AddRef)(
+      IPolicyConfig *This);
+
+  /*
+   * Decrease the COM reference count.
+   *
+   * When you are done with the object, call:
+   *
+   *   policy_config->lpVtbl->Release(policy_config);
+   */
+  ULONG(STDMETHODCALLTYPE *Release)(
+      IPolicyConfig *This);
+
+  /*
+   * Get the mix format for an audio endpoint.
+   */
+  HRESULT(STDMETHODCALLTYPE *GetMixFormat)(
+      IPolicyConfig *This,
+      PCWSTR wszDeviceId,
+      WAVEFORMATEX **ppFormat);
+
+  /*
+   * Get the device format for an audio endpoint.
+   */
+  HRESULT(STDMETHODCALLTYPE *GetDeviceFormat)(
+      IPolicyConfig *This,
+      PCWSTR wszDeviceId,
+      INT bDefault,
+      WAVEFORMATEX **ppFormat);
+
+  /*
+   * Reset the device format.
+   *
+   * This method exists in the modern IPolicyConfig layout.
+   */
+  HRESULT(STDMETHODCALLTYPE *ResetDeviceFormat)(
+      IPolicyConfig *This,
+      PCWSTR wszDeviceId);
+
+  /*
+   * Set the device format.
+   */
+  HRESULT(STDMETHODCALLTYPE *SetDeviceFormat)(
+      IPolicyConfig *This,
+      PCWSTR wszDeviceId,
+      WAVEFORMATEX *pEndpointFormat,
+      WAVEFORMATEX *pMixFormat);
+
+  /*
+   * Get the processing period for an audio endpoint.
+   */
+  HRESULT(STDMETHODCALLTYPE *GetProcessingPeriod)(
+      IPolicyConfig *This,
+      PCWSTR wszDeviceId,
+      INT bDefault,
+      PINT64 pmftDefaultPeriod,
+      PINT64 pmftMinimumPeriod);
+
+  /*
+   * Set the processing period for an audio endpoint.
+   */
+  HRESULT(STDMETHODCALLTYPE *SetProcessingPeriod)(
+      IPolicyConfig *This,
+      PCWSTR wszDeviceId,
+      PINT64 pmftPeriod);
+
+  /*
+   * Get the sharing mode for an audio endpoint.
+   */
+  HRESULT(STDMETHODCALLTYPE *GetShareMode)(
+      IPolicyConfig *This,
+      PCWSTR wszDeviceId,
+      DeviceShareMode *pMode);
+
+  /*
+   * Set the sharing mode for an audio endpoint.
+   */
+  HRESULT(STDMETHODCALLTYPE *SetShareMode)(
+      IPolicyConfig *This,
+      PCWSTR wszDeviceId,
+      DeviceShareMode *pMode);
+
+  /*
+   * Get a property value from an audio endpoint.
+   */
+  HRESULT(STDMETHODCALLTYPE *GetPropertyValue)(
+      IPolicyConfig *This,
+      PCWSTR wszDeviceId,
+      const PROPERTYKEY *key,
+      PROPVARIANT *pv);
+
+  /*
+   * Set a property value on an audio endpoint.
+   */
+  HRESULT(STDMETHODCALLTYPE *SetPropertyValue)(
+      IPolicyConfig *This,
+      PCWSTR wszDeviceId,
+      const PROPERTYKEY *key,
+      PROPVARIANT *pv);
+
+  /*
+   * Set the default audio endpoint for a specific Windows audio role.
+   *
+   * Common roles:
+   *
+   *   eConsole
+   *     Normal system/default device.
+   *
+   *   eMultimedia
+   *     Media playback device.
+   *
+   *   eCommunications
+   *     Calls/communication device.
+   *
+   * Usually, when changing the default device, you call this three times:
+   *
+   *   policy_config->lpVtbl->SetDefaultEndpoint(policy_config, id, eConsole);
+   *   policy_config->lpVtbl->SetDefaultEndpoint(policy_config, id, eMultimedia);
+   *   policy_config->lpVtbl->SetDefaultEndpoint(policy_config, id, eCommunications);
+   */
+  HRESULT(STDMETHODCALLTYPE *SetDefaultEndpoint)(
+      IPolicyConfig *This,
+      PCWSTR wszDeviceId,
+      ERole eRole);
+
+  /*
+   * Show or hide an endpoint.
+   *
+   * Not needed for the first version of the library, but it belongs in the
+   * vtable because the real COM interface has it.
+   */
+  HRESULT(STDMETHODCALLTYPE *SetEndpointVisibility)(
+      IPolicyConfig *This,
+      PCWSTR wszDeviceId,
+      INT bVisible);
+};
+
+/* ---------------------------------------------------------------------------------------------- */
+/* IPolicyConfigVista                                                                               */
+/* ---------------------------------------------------------------------------------------------- */
+
+/*
+ * Vista-era COM object layout.
+ *
+ * Same idea as IPolicyConfig:
+ *
+ *   vista_config->lpVtbl->SetDefaultEndpoint(vista_config, device_id, eConsole);
+ */
+struct IPolicyConfigVista {
+  const IPolicyConfigVistaVtbl *lpVtbl;
+};
+
+/*
+ * Vtable for the older Vista-era PolicyConfig interface.
+ *
+ * Important difference:
+ * The Vista-era layout does not have ResetDeviceFormat in the same place as
+ * the modern IPolicyConfig interface.
+ *
+ * That is why this is defined separately.
+ */
+struct IPolicyConfigVistaVtbl {
+  /*
+   * Standard COM IUnknown methods.
+   */
+  HRESULT(STDMETHODCALLTYPE *QueryInterface)(
+      IPolicyConfigVista *This,
+      REFIID riid,
+      void **ppvObject);
+
+  ULONG(STDMETHODCALLTYPE *AddRef)(
+      IPolicyConfigVista *This);
+
+  ULONG(STDMETHODCALLTYPE *Release)(
+      IPolicyConfigVista *This);
+
+  /*
+   * Get the mix format for an audio endpoint.
+   */
+  HRESULT(STDMETHODCALLTYPE *GetMixFormat)(
+      IPolicyConfigVista *This,
+      PCWSTR wszDeviceId,
+      WAVEFORMATEX **ppFormat);
+
+  /*
+   * Get the device format for an audio endpoint.
+   */
+  HRESULT(STDMETHODCALLTYPE *GetDeviceFormat)(
+      IPolicyConfigVista *This,
+      PCWSTR wszDeviceId,
+      INT bDefault,
+      WAVEFORMATEX **ppFormat);
+
+  /*
+   * Set the device format.
+   *
+   * Notice that ResetDeviceFormat is not here in the Vista-era layout.
+   */
+  HRESULT(STDMETHODCALLTYPE *SetDeviceFormat)(
+      IPolicyConfigVista *This,
+      PCWSTR wszDeviceId,
+      WAVEFORMATEX *pEndpointFormat,
+      WAVEFORMATEX *pMixFormat);
+
+  /*
+   * Get the processing period for an audio endpoint.
+   */
+  HRESULT(STDMETHODCALLTYPE *GetProcessingPeriod)(
+      IPolicyConfigVista *This,
+      PCWSTR wszDeviceId,
+      INT bDefault,
+      PINT64 pmftDefaultPeriod,
+      PINT64 pmftMinimumPeriod);
+
+  /*
+   * Set the processing period for an audio endpoint.
+   */
+  HRESULT(STDMETHODCALLTYPE *SetProcessingPeriod)(
+      IPolicyConfigVista *This,
+      PCWSTR wszDeviceId,
+      PINT64 pmftPeriod);
+
+  /*
+   * Get the sharing mode for an audio endpoint.
+   */
+  HRESULT(STDMETHODCALLTYPE *GetShareMode)(
+      IPolicyConfigVista *This,
+      PCWSTR wszDeviceId,
+      DeviceShareMode *pMode);
+
+  /*
+   * Set the sharing mode for an audio endpoint.
+   */
+  HRESULT(STDMETHODCALLTYPE *SetShareMode)(
+      IPolicyConfigVista *This,
+      PCWSTR wszDeviceId,
+      DeviceShareMode *pMode);
+
+  /*
+   * Get a property value from an audio endpoint.
+   */
+  HRESULT(STDMETHODCALLTYPE *GetPropertyValue)(
+      IPolicyConfigVista *This,
+      PCWSTR wszDeviceId,
+      const PROPERTYKEY *key,
+      PROPVARIANT *pv);
+
+  /*
+   * Set a property value on an audio endpoint.
+   */
+  HRESULT(STDMETHODCALLTYPE *SetPropertyValue)(
+      IPolicyConfigVista *This,
+      PCWSTR wszDeviceId,
+      const PROPERTYKEY *key,
+      PROPVARIANT *pv);
+
+  /*
+   * Set the default audio endpoint for a specific Windows audio role.
+   */
+  HRESULT(STDMETHODCALLTYPE *SetDefaultEndpoint)(
+      IPolicyConfigVista *This,
+      PCWSTR wszDeviceId,
+      ERole eRole);
+
+  /*
+   * Show or hide an endpoint.
+   */
+  HRESULT(STDMETHODCALLTYPE *SetEndpointVisibility)(
+      IPolicyConfigVista *This,
+      PCWSTR wszDeviceId,
+      INT bVisible);
+};
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* TRUEHEAR_IPOLICY_CONFIG_H */

package/include/mmdevice_guids.h

@@ -0,0 +1,9 @@
+#ifndef MMDEVICE_GUIDS_H
+#define MMDEVICE_GUIDS_H
+
+#include <windows.h>
+
+extern const CLSID CLSID_MMDeviceEnumerator;
+extern const IID IID_IMMDeviceEnumerator;
+
+#endif