IAudioProcessingObject::IsOutputFormatSupported-Methode (audioenginebaseapo.h)
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 |
|---|---|
|
Das Format des Eingabe-/Ausgabeformatpaars wird nicht unterstützt. Der ppSupportedOutPutFormat-Parameter gibt ein vorgeschlagenes neues Format zurück. |
|
Das Format wird nicht unterstützt. Der Wert von ppSupportedOutputFormat ändert sich nicht. |
|
Ein ungültiger Zeiger wurde an die Funktion übergeben. Der Wert von ppSupportedOutputFormat ändert sich nicht. |
|
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 |