Metodo IAudioProcessingObjectPreferredFormatSupport::GetPreferredInputFormat (audioengineextensionapo.h)

Funzione di callback che consente alle API di specificare un formato di input preferito per il formato di output specificato.

Sintassi

HRESULT GetPreferredInputFormat(
  [in]  IAudioMediaType *outputFormat,
  [out] IAudioMediaType **preferredFormat
);

Parametri

[in] outputFormat

IAudioMediaType che rappresenta il formato di output associato al callback.

[out] preferredFormat

IAudioMediaType che rappresenta il formato di input preferito per l'APO.

Valore restituito

An HRESULT.

Commenti

Questa API consente scenari come un provider di cuffie che fornisce audio surround virtuale. L'APO potrebbe richiedere di ricevere l'input da 7 a 1 anche se l'endpoint esegue il rendering in stereo. Le API possono specificare formati preferiti diversi per formati di output diversi. Ad esempio, un'app può richiedere 7.1 input quando il tipo di flusso m è multimediale, ma richiedere l'input stereo quando il tipo di flusso è comunicazioni.

Requisiti

Requisito Valore
Client minimo supportato Windows 11 versione 23H2
Intestazione audioengineextensionapo.h