IMDSPDevice3::GetFormatCapability-Methode (mswmdm.h)

Artikel
03/05/2025

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

Aufzählungswert, 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 Device Manager können eine der folgenden Klassen von Fehlercodes zurückgeben:

Standard-COM-Fehlercodes
Windows-Fehlercodes, die in HRESULT-Werte konvertiert wurden
Windows Media Device Manager –Fehlercodes

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

Bemerkungen

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.

Bei einem bestimmten Format sollte diese Methode alle Konfigurationen unterstützter Eigenschaften zurückgeben (z. B. Kombinationen von Bitrate und Samplerate). Diese Informationen werden als Formatfunktion ausgedrückt. Ausführliche Informationen finden Sie unter WMDM_FORMAT_CAPABILITY.