Informace o rozhraní MMDevice API

Rozhraní API mmDevice (Windows Multimedia Device) umožňuje zvukovým klientům zjišťovat zařízení se zvukovými koncovými body, určit jejich schopnosti a vytvářet instance ovladačů pro tato zařízení.

Hlavičkový soubor Mmdeviceapi.h definuje rozhraní v rozhraní API MMDevice.

Rozhraní MMDevice API se skládá z několika rozhraní. Rozhraní IMMDeviceEnumerator je první z nich. Pro přístup k rozhraním MMDevice API klient získá referenci na rozhraní IMMDeviceEnumerator objektu device-enumerator voláním funkce CoCreateInstance, jak je znázorněno v následujícím fragmentu kódu.

  const CLSID CLSID_MMDeviceEnumerator = __uuidof(MMDeviceEnumerator);
  const IID IID_IMMDeviceEnumerator = __uuidof(IMMDeviceEnumerator);
  hr = CoCreateInstance(
         CLSID_MMDeviceEnumerator, NULL,
         CLSCTX_ALL, IID_IMMDeviceEnumerator,
         (void**)&pEnumerator);

V předchozím fragmentu kódu jsou CLSID_MMDeviceEnumerator a IID_IMMDeviceEnumerator hodnoty GUID, které jsou připojeny jako atributy k MMDeviceEnumerator objekt třídy a IMMDeviceEnumerator rozhraní. Volání CoCreateInstance tyto hodnoty předá odkazem. Proměnná hr je typu HRESULTa proměnná pEnumerator je ukazatel na rozhraní IMMDeviceEnumerator objektu enumerátoru zařízení. IMMDeviceEnumerator poskytuje metody pro výčet zařízení se zvukovými koncovými body. Informace o operátoru __uuidof, funkci CoCreateInstance a konstantách CLSCTX_Xxx najdete v dokumentaci k sadě Windows SDK.

Prostřednictvím rozhraní IMMDeviceEnumerator může klient získat odkazy na ostatní rozhraní v rozhraní MMDevice API. Rozhraní MMDevice API implementuje následující rozhraní.

Rozhraní Popis
IMMDevice Představuje zvukové zařízení.
IMMDeviceCollection Představuje kolekci zvukových zařízení.
IMMDeviceEnumerator Poskytuje metody pro výčet zvukových zařízení.
IMMEndpoint Představuje zařízení zvukového koncového bodu.

 

Klienti rozhraní MMDevice API, kteří vyžadují oznámení o změnách stavu v zařízeních koncových bodů zvuku, by navíc měli implementovat následující rozhraní.

Rozhraní Popis
IMMNotificationClient Poskytuje oznámení při přidání nebo odebrání zvukového koncového bodu, při změně stavu nebo vlastností zařízení nebo při změně výchozí role přiřazené k zařízení.

 

zařízení zvukových koncových bodů

Referenční programování

 

 

  • Last updated on