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

  • Article

La IsEqual méthode compare deux types de supports et détermine s’ils sont identiques.

Syntaxe

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

Paramètres

[in] pIAudioType

Spécifie un pointeur vers une interface IAudioMediaType du type de média à comparer.

[out] pdwFlags

Spécifie un pointeur vers une variable DWORD qui contient le résultat OR au niveau du bit de zéro ou plusieurs indicateurs. Ces indicateurs indiquent le degré de similarité entre les deux types de supports. Le tableau suivant présente les indicateurs pris en charge.

Indicateur Signification
AUDIOMEDIATYPE_EQUAL_FORMAT_TYPES Les types de format audio sont les mêmes.
AUDIOMEDIATYPE_EQUAL_FORMAT_DATA Les informations de format correspondent, sans inclure les données supplémentaires au-delà de la structure WAVEFORMATEX de base.
AUDIOMEDIATYPE_EQUAL_FORMAT_USER_DATA Les données supplémentaires sont identiques ou aucun type de média ne contient de données supplémentaires.

Valeur retournée

La IsEqual méthode retourne S_OK si elle réussit, sinon elle retourne l’une des valeurs HRESULT indiquées dans le tableau suivant.

Code de retour Description
E_INVALIDARG
 Un type de média n’est pas valide ou les deux types de média ne sont pas valides.
S_FALSE
 Les types de média ne sont pas égaux. Examinez le paramètre pdwFlags pour déterminer les différences entre les types de média.

Remarques

Les deux types de média doivent avoir un type principal, sinon la méthode retourne E_INVALIDARG. Pour plus d’informations sur les types de médias, consultez Types de médias.

L’indicateur MF_MEDIATYPE_EQUAL_FORMAT_DATA indique que les deux types de média ont des attributs compatibles, bien que l’un puisse être un sur-ensemble de l’autre. Cette méthode de comparaison signifie que vous pouvez comparer un type de média partiellement spécifié à un type de média complet. Par exemple, vous pouvez avoir deux types de vidéo qui décrivent le même format, mais un type inclut des attributs pour les informations de couleur étendues (emplacement chromatique, plage nominale, etc.).

Si la méthode réussit et que tous les indicateurs de comparaison sont définis dans pdwFlags, la valeur de retour est S_OK. Si la méthode réussit mais que certains indicateurs de comparaison ne sont pas définis, la méthode retourne S_FALSE.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible dans Windows Vista et les versions plus récentes de Windows.
Plateforme cible Desktop (Expérience utilisateur)
En-tête audiomediatype.h (inclure Audiomediatype.h)
IRQL Tous les niveaux.

Voir aussi

IAudioMediaType

Types de média

WAVEFORMATEX