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

  • Artículo

El IsEqual método compara dos tipos multimedia y determina si son idénticos.

Sintaxis

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

Parámetros

[in] pIAudioType

Especifica un puntero a una interfaz IAudioMediaType del tipo de medio que se va a comparar.

[out] pdwFlags

Especifica un puntero a una variable DWORD que contiene el resultado OR bit a bit de cero o más marcas. Estas marcas indican el grado de similitud entre los dos tipos multimedia. En la tabla siguiente se muestran las marcas admitidas.

Marca Significado
AUDIOMEDIATYPE_EQUAL_FORMAT_TYPES Los tipos de formato de audio son los mismos.
AUDIOMEDIATYPE_EQUAL_FORMAT_DATA La información de formato coincide, sin incluir datos adicionales más allá de la estructura BASE WAVEFORMATEX .
AUDIOMEDIATYPE_EQUAL_FORMAT_USER_DATA Los datos adicionales son idénticos o ninguno de los tipos de medios contiene datos adicionales.

Valor devuelto

El IsEqual método devuelve S_OK si se realiza correctamente; de lo contrario, devuelve uno de los valores HRESULT que se muestran en la tabla siguiente.

Código devuelto Descripción
E_INVALIDARG
 Un tipo de medio no es válido o ambos tipos de medios no son válidos.
S_FALSE
 Los tipos multimedia no son iguales. Examine el parámetro pdwFlags para determinar cómo difieren los tipos multimedia.

Comentarios

Ambos tipos de medios deben tener un tipo principal; de lo contrario, el método devuelve E_INVALIDARG. Para obtener más información sobre los tipos de medios, vea Tipos de medios.

La marca MF_MEDIATYPE_EQUAL_FORMAT_DATA indica que ambos tipos de medios tienen atributos compatibles, aunque uno podría ser un superconjunto del otro. Este método de comparación significa que puede comparar un tipo de medio especificado parcialmente con un tipo de medio completo. Por ejemplo, puede tener dos tipos de vídeo que describen el mismo formato, pero un tipo incluye atributos para la información de color extendida (sima cromática, rango nominal, etc.).

Si el método se realiza correctamente y todas las marcas de comparación se establecen en pdwFlags, el valor devuelto se S_OK. Si el método se realiza correctamente, pero no se establecen algunas marcas de comparación, el método devuelve S_FALSE.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible en Windows Vista y versiones posteriores de Windows.
Plataforma de destino Escritorio
Encabezado audiomediatype.h (include Audiomediatype.h)
IRQL Todos los niveles.

Consulte también

IAudioMediaType

Tipos de medios

WAVEFORMATEX