Método IAudioProcessingObject::IsOutputFormatSupported (audioenginebaseapo.h)

O IsOutputFormatSupported método é usado para verificar se há suporte para um formato de saída específico.

Sintaxe

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

Parâmetros

[in, optional] pOppositeFormat

Um ponteiro para uma interface IAudioMediaType. Esse parâmetro indica o formato de saída. Esse parâmetro deve ser definido como NULL para indicar que o formato de saída pode ser qualquer tipo.

[in, optional] pRequestedOutputFormat

Um ponteiro para uma interface IAudioMediaType . Esse parâmetro indica o formato de saída a ser verificado.

[out, optional] ppSupportedOutputFormat

Esse parâmetro indica o formato de saída com suporte mais próximo do formato a ser verificado.

Retornar valor

Se a chamada for concluída com êxito, o parâmetro ppSupportedOutputFormat retornará um ponteiro pRequestedOutputFormat e o método IsOutputFormatSupported retornará um valor de S_OK. Caso contrário, esse método retornará um dos seguintes códigos de erro:

Código de retorno	Descrição
S_FALSE	Não há suporte para o formato de par de formato de entrada/saída. O parâmetro ppSupportedOutPutFormat retorna um novo formato sugerido.
APOERR_FORMAT_NOT_SUPPORTED	Não há suporte para o formato . O valor de ppSupportedOutputFormat não é alterado.
E_POINTER	Um ponteiro inválido foi passado para a função . O valor de ppSupportedOutputFormat não é alterado.
Outros valores HRESULT	Essas condições de erro adicionais são controladas pelo mecanismo de áudio.

Comentários

Há diferenças na implementação do IsOutputFormatSupported método pelas diferentes APOs. Por exemplo, com determinadas implementações, a saída só pode ser do tipo float quando o formato de entrada é do tipo inteiro.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível com o Windows Vista e versões posteriores do sistema operacional Windows.
Plataforma de Destino	Universal
Cabeçalho	audioenginebaseapo.h
Biblioteca	Audioenginebaseapo.idl
IRQL	Todos os Níveis

Confira também

IAudioMediaType

IAudioProcessingObject