Metodo IApoAuxiliaryInputConfiguration::IsInputFormatSupported (audioenginebaseapo.h)

Articolo
02/23/2024

Verifica che un formato di input ausiliario specifico sia supportato dall'APO.

Sintassi

HRESULT IsInputFormatSupported(
  IAudioMediaType *pRequestedInputFormat,
  IAudioMediaType **ppSupportedInputFormat
);

Parametri

pRequestedInputFormat

Formato di input da verificare.

ppSupportedInputFormat

L'apo popola questo parametro con il formato di input supportato più vicino al formato passato al metodo .

Valore restituito

HRESULT

HRESULT	Descrizione
S_OK	Completamento. L'APO deve aggiungere un riferimento a pRequestedInputFormat e restituirlo in ppSupportedInputFormat
S_FALSE	Il formato non è supportato. L'APO deve restituire un formato supportato suggerito in ppSupportedInputFormat
APOERR_FORMAT_NOT_SUPPORTED	Il formato non è supportato. L'apo non deve modificare ppSupportedInputFormat
E_POINTER	Puntatore non valido passato a questa funzione.
Altri valori	Un altro componente causa un errore. Questi errori vengono rilevati dal sistema.

Commenti

Se l'apo può accettare il formato richiesto, deve aggiungere un riferimento al formato richiesto, restituirlo come formato di output supportato e restituire S_OK.

Se l'APO non può accettare il formato richiesto, può suggerire un formato alternativo richiesto. In questo caso, deve creare e restituire il formato suggerito e restituire S_FALSE.

Il formato supportato restituito deve essere "più vicino" al formato richiesto, ovvero il formato deve avere gli stessi valori per le proprietà seguenti, specificate nell'ordine di priorità.

formato di esempio
profondità bit
numero di canali
frequenza di campionamento

Il formato suggerito può essere diverso solo dal formato richiesto se viene restituito S_FALSE. Quando si restituisce un errore, il formato suggerito deve essere lasciato invariato.

Questa API può essere chiamata in qualsiasi momento. I risultati restituiti dipendono dallo stato interno dell'APO che può essere manipolato da interfacce utente esterne. Una volta bloccato l'apo per l'elaborazione, tuttavia, questo formato non può e non verrà modificato.

Questo metodo potrebbe non essere chiamato da un thread di elaborazione in tempo reale.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10 Build 20348
Intestazione	audioenginebaseapo.h

Condividi tramite