Metodo IAudioProcessingObject::IsOutputFormatSupported (audioenginebaseapo.h)

Articolo
02/23/2024

Il IsOutputFormatSupported metodo viene usato per verificare che sia supportato un formato di output specifico.

Sintassi

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

Parametri

[in, optional] pOppositeFormat

Puntatore a un'interfaccia IAudioMediaType. Questo parametro indica il formato di output. Questo parametro deve essere impostato su NULL per indicare che il formato di output può essere qualsiasi tipo.

[in, optional] pRequestedOutputFormat

Puntatore a un'interfaccia IAudioMediaType . Questo parametro indica il formato di output da verificare.

[out, optional] ppSupportedOutputFormat

Questo parametro indica il formato di output supportato più vicino al formato da verificare.

Valore restituito

Se la chiamata viene completata correttamente, il parametro ppSupportedOutputFormat restituisce un puntatore pRequestedOutputFormat e il metodo IsOutputFormatSupported restituisce un valore di S_OK. In caso contrario, questo metodo restituisce uno dei codici di errore seguenti:

Codice restituito	Descrizione
S_FALSE	Il formato della coppia di formati di input/output non è supportato. Il parametro ppSupportedOutPutFormat restituisce un nuovo formato suggerito.
APOERR_FORMAT_NOT_SUPPORTED	Il formato non è supportato. Il valore di ppSupportedOutputFormat non cambia.
E_POINTER	Un puntatore non valido è stato passato alla funzione. Il valore di ppSupportedOutputFormat non cambia.
Altri valori HRESULT	Queste condizioni di errore aggiuntive vengono rilevate dal motore audio.

Commenti

Esistono differenze nell'implementazione del IsOutputFormatSupported metodo in base alle diverse API. Ad esempio, con alcune implementazioni, l'output può essere di tipo float solo quando il formato di input è di tipo integer.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile con Windows Vista e versioni successive del sistema operativo Windows.
Piattaforma di destinazione	Universale
Intestazione	audioenginebaseapo.h
Libreria	Audioenginebaseapo.idl
IRQL	Tutti i livelli

Vedi anche

IAudioMediaType

IAudioProcessingObject

Condividi tramite