IKsFormatSupport::IsFormatSupported-Methode (devicetopology.h)

  • Artikel

Die IsFormatSupported-Methode gibt an, ob das Audioendpunktgerät das angegebene Audiostreamformat unterstützt.

Syntax

HRESULT IsFormatSupported(
  [in]  PKSDATAFORMAT pKsFormat,
  [in]  DWORD         cbFormat,
  [out] BOOL          *pbSupported
);

Parameter

[in] pKsFormat

Zeiger auf einen Audiostreamformatbezeichner. Dieser Parameter verweist auf einen vom Aufrufer zugewiesenen Puffer, der einen Formatbezeichner enthält. Der Bezeichner beginnt mit einer KSDATAFORMAT-Struktur , auf die möglicherweise zusätzliche Formatinformationen folgen. Weitere Informationen zu KSDATAFORMAT und Formatbezeichnern finden Sie in der Dokumentation zu Windows DDK.

[in] cbFormat

Die Größe des Puffers in Bytes, der den Formatbezeichner enthält.

[out] pbSupported

Zeiger auf eine BOOL-Variable , in die die -Methode einen Wert schreibt, um anzugeben, ob das Format unterstützt wird. Die -Methode schreibt TRUE , wenn das Gerät das Format unterstützt, und FALSE , wenn das Gerät das Format nicht unterstützt.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn ein Fehler auftritt, können mögliche Rückgabecodes die in der folgenden Tabelle gezeigten Werte umfassen, sind jedoch nicht darauf beschränkt.

Rückgabecode Beschreibung
E_POINTER
 Zeiger pKsFormat oder pbSupported ist NULL.
E_INVALIDARG
 Der Formatbezeichner ist ungültig.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile devicetopology.h

Weitere Informationen

IKsFormatSupport-Schnittstelle