IMDSPDevice3::GetFormatCapability-Methode (mswmdm.h)

Artikel
08/25/2023

Die GetFormatCapability-Methode ruft Informationen von einem Gerät über die Werte oder Wertebereiche ab, die vom Gerät für jeden Aspekt eines bestimmten Objektformats unterstützt werden.

Syntax

HRESULT GetFormatCapability(
  [in]  WMDM_FORMATCODE        format,
  [out] WMDM_FORMAT_CAPABILITY *pFormatSupport
);

Parameter

[in] format

WMDM_FORMATCODE

Aufgezählter Wert, der das angefragte Format darstellt.

[out] pFormatSupport

Gibt WMDM_FORMAT_CAPABILITY Struktur zurück, die die Werte oder Wertebereiche enthält, die für jeden Aspekt eines bestimmten Objektformats unterstützt werden.

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:

Com-Standardfehlercodes
In HRESULT-Werte konvertierte Windows-Fehlercodes
Windows Media Geräte-Manager Fehlercodes

Eine ausführliche Liste möglicher Fehlercodes finden Sie unter Fehlercodes.

Hinweise

Diese Methode kann für jedes der unterstützten Formate aufgerufen werden. Die Liste der unterstützten Formate wird durch g_wszWMDMFormatsSupported Geräteeigenschaft dargestellt.

Für ein bestimmtes Format sollte diese Methode alle Konfigurationen unterstützter Eigenschaften zurückgeben (z. B. Kombinationen aus Bitrate und Samplerate). Diese Informationen werden als Formatfunktion ausgedrückt. Ausführliche Informationen finden Sie unter WMDM_FORMAT_CAPABILITY.