IWMDMDevice2::GetFormatSupport2-Methode (mswmdm.h)

Artikel
08/25/2023

Die GetFormatSupport2-Methode ruft die vom Gerät unterstützten Formate ab, einschließlich Audio- und Videocodecs sowie MIME-Dateiformate.

Syntax

HRESULT GetFormatSupport2(
  [in]  DWORD              dwFlags,
  [out] _WAVEFORMATEX      **ppAudioFormatEx,
  [out] UINT               *pnAudioFormatCount,
  [out] _VIDEOINFOHEADER   **ppVideoFormatEx,
  [out] UINT               *pnVideoFormatCount,
  [out] WMFILECAPABILITIES **ppFileType,
  [out] UINT               *pnFileTypeCount
);

Parameter

[in] dwFlags

DWORD , das Audioformate, Videoformate und MIME-Typen angibt. Dieses Flag gibt an, was die Anwendung an den Dienstanbieter anfordert. Der Aufrufer kann einen oder mehrere der folgenden drei Werte festlegen.

Wert	BESCHREIBUNG
WMDM_GET_FORMAT_SUPPORT_AUDIO	Der Dienstanbieter sollte Audioparameter eingeben.
WMDM_GET_FORMAT_SUPPORT_VIDEO	Der Dienstanbieter sollte Videoparameter eingeben.
WMDM_GET_FORMAT_SUPPORT_FILE	Der Dienstanbieter sollte Dateiparameter eingeben.

[out] ppAudioFormatEx

Zeiger auf ein Array von _WAVEFORMATEX Strukturen, die Informationen zu Audiocodecs und Bitraten angeben, die vom Gerät unterstützt werden. Der Arbeitsspeicher für diesen Parameter wird von Windows Media Geräte-Manager zugeordnet und muss vom Aufrufer mit der Win32-Funktion CoTaskMemFree freigegeben werden.

[out] pnAudioFormatCount

Zeiger auf eine ganze Zahl, die die Anzahl des Audioformats angibt.

[out] ppVideoFormatEx

Zeiger auf ein Array von _VIDEOFORMATEX Strukturen, die Informationen zu Videocodes und Formaten angeben, die vom Gerät unterstützt werden. Der Arbeitsspeicher für diesen Parameter wird von Windows Media Geräte-Manager zugeordnet und muss vom Aufrufer mit der Win32-Funktion CoTaskMemFree freigegeben werden.

[out] pnVideoFormatCount

Zeiger auf eine ganze Zahl, die die Videoformatanzahl angibt.

[out] ppFileType

Zeiger auf ein Array von WMFILECAPABILITIES-Dateitypobjekten . Der Arbeitsspeicher für diesen Parameter wird von Windows Media Geräte-Manager zugeordnet und muss vom Aufrufer mit der Win32-Funktion CoTaskMemFree freigegeben werden.

[out] pnFileTypeCount

Zeiger auf eine ganze Zahl, die die Anzahl der Dateitypen angibt.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Alle Schnittstellenmethoden in Windows Media Geräte-Manager können eine der folgenden Klassen von Fehlercodes zurückgeben:

Standard-COM-Fehlercodes
In HRESULT-Werte konvertierte Windows-Fehlercodes
Windows Media Geräte-Manager Fehlercodes

Eine umfassende Liste möglicher Fehlercodes finden Sie unter Fehlercodes.

Hinweise

Diese Methode erweitert IWMDMDevice::GetFormatSupport , um Videoformate zu verarbeiten. Die empfohlene Methode zum Abrufen der Formatunterstützung ist jedoch IWMDMDevice3::GetFormatCapability. Wenn GetFormatCapability nicht unterstützt wird, unterstützt das Gerät wahrscheinlich kein Video, und GetFormatSupport ist wahrscheinlich ausreichend.