Metodo IAudioProcessingObject::IsOutputFormatSupported (audioenginebaseapo.h)

  • Articolo

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