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.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	mswmdm.h
Bibliothek	Mssachlp.lib

Weitere Informationen

Ermitteln von Geräteformatfunktionen

IWMDMDevice2-Schnittstelle

IWMDMDevice3::GetFormatCapability

Freigeben über