Share via

Método IAudioMediaType::IsEqual (audiomediatype.h)

  • Artigo

O IsEqual método compara dois tipos de mídia e determina se eles são idênticos.

Sintaxe

HRESULT IsEqual(
  [in]  IAudioMediaType *pIAudioType,
  [out] DWORD           *pdwFlags
);

Parâmetros

[in] pIAudioType

Especifica um ponteiro para uma interface IAudioMediaType do tipo de mídia a ser comparada.

[out] pdwFlags

Especifica um ponteiro para uma variável DWORD que contém o resultado OR bit a bit de zero ou mais sinalizadores. Esses sinalizadores indicam o grau de similaridade entre os dois tipos de mídia. A tabela a seguir mostra os sinalizadores com suporte.

Sinalizador Significado
AUDIOMEDIATYPE_EQUAL_FORMAT_TYPES Os tipos de formato de áudio são os mesmos.
AUDIOMEDIATYPE_EQUAL_FORMAT_DATA As informações de formato correspondem, não incluindo dados extras além da estrutura BASE WAVEFORMATEX .
AUDIOMEDIATYPE_EQUAL_FORMAT_USER_DATA Os dados extras são idênticos ou nenhum tipo de mídia contém dados extras.

Retornar valor

O IsEqual método retornará S_OK se for bem-sucedido, caso contrário, retornará um dos valores HRESULT mostrados na tabela a seguir.

Código de retorno Descrição
E_INVALIDARG
 Um tipo de mídia é inválido ou ambos os tipos de mídia são inválidos.
S_FALSE
 Os tipos de mídia não são iguais. Examine o parâmetro pdwFlags para determinar como os tipos de mídia diferem.

Comentários

Ambos os tipos de mídia devem ter um tipo principal; caso contrário, o método retorna E_INVALIDARG. Para obter mais informações sobre tipos de mídia, consulte Tipos de mídia.

O sinalizador MF_MEDIATYPE_EQUAL_FORMAT_DATA indica que ambos os tipos de mídia têm atributos compatíveis, embora um possa ser um superconjunto do outro. Esse método de comparação significa que você pode comparar um tipo de mídia parcialmente especificado com um tipo de mídia completo. Por exemplo, você pode ter dois tipos de vídeo que descrevem o mesmo formato, mas um tipo inclui atributos para informações de cor estendidas (chroma siting, intervalo nominal e assim por diante).

Se o método for bem-sucedido e todos os sinalizadores de comparação forem definidos em pdwFlags, o valor retornado será S_OK. Se o método for bem-sucedido, mas alguns sinalizadores de comparação não forem definidos, o método retornará S_FALSE.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Windows Vista e versões posteriores do Windows.
Plataforma de Destino Área de Trabalho
Cabeçalho audiomediatype.h (inclua Audiomediatype.h)
IRQL Todos os níveis.

Confira também

IAudioMediaType

Tipos de mídia

WAVEFORMATEX