Share via

IAudioProcessingObject::IsOutputFormatSupported-Methode (audioenginebaseapo.h)

  • Artikel

Die IsOutputFormatSupported -Methode wird verwendet, um zu überprüfen, ob ein bestimmtes Ausgabeformat unterstützt wird.

Syntax

HRESULT IsOutputFormatSupported(
  [in, optional]  IAudioMediaType *pOppositeFormat,
  [in, optional]  IAudioMediaType *pRequestedOutputFormat,
  [out, optional] IAudioMediaType **ppSupportedOutputFormat
);

Parameter

[in, optional] pOppositeFormat

Ein Zeiger auf eine IAudioMediaType-Schnittstelle. Dieser Parameter gibt das Ausgabeformat an. Dieser Parameter muss auf NULL festgelegt werden, um anzugeben, dass das Ausgabeformat ein beliebiger Typ sein kann.

[in, optional] pRequestedOutputFormat

Ein Zeiger auf eine IAudioMediaType-Schnittstelle . Dieser Parameter gibt das zu überprüfende Ausgabeformat an.

[out, optional] ppSupportedOutputFormat

Dieser Parameter gibt das unterstützte Ausgabeformat an, das dem zu überprüfenden Format am nächsten kommt.

Rückgabewert

Wenn der Aufruf erfolgreich abgeschlossen wird, gibt der ppSupportedOutputFormat-Parameter einen pRequestedOutputFormat-Zeiger und die IsOutputFormatSupported-Methode den Wert S_OK zurück. Andernfalls gibt diese Methode einen der folgenden Fehlercodes zurück:

Rückgabecode Beschreibung
S_FALSE
 Das Format des Eingabe-/Ausgabeformatpaars wird nicht unterstützt. Der ppSupportedOutPutFormat-Parameter gibt ein vorgeschlagenes neues Format zurück.
APOERR_FORMAT_NOT_SUPPORTED
 Das Format wird nicht unterstützt. Der Wert von ppSupportedOutputFormat ändert sich nicht.
E_POINTER
 Ein ungültiger Zeiger wurde an die Funktion übergeben. Der Wert von ppSupportedOutputFormat ändert sich nicht.
Andere HRESULT-Werte
 Diese zusätzlichen Fehlerbedingungen werden von der Audio-Engine nachverfolgt.

Hinweise

Es gibt Unterschiede in der Implementierung der IsOutputFormatSupported Methode durch die verschiedenen APOs. Bei bestimmten Implementierungen kann die Ausgabe beispielsweise nur vom Typ float sein, wenn das Eingabeformat vom Typ integer ist.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar mit Windows Vista und höheren Versionen des Windows-Betriebssystems.
Zielplattform Universell
Header audioenginebaseapo.h
Bibliothek Audioenginebaseapo.idl
IRQL Alle Ebenen

Weitere Informationen

IAudioMediaType

IAudioProcessingObject