Metodo IAudioMediaType::IsEqual (audiomediatype.h)

  • Articolo

Il IsEqual metodo confronta due tipi di supporti e determina se sono identici.

Sintassi

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

Parametri

[in] pIAudioType

Specifica un puntatore a un'interfaccia IAudioMediaType del tipo di supporto da confrontare.

[out] pdwFlags

Specifica un puntatore a una variabile DWORD contenente il risultato OR bit per bit di zero o più flag. Questi flag indicano il grado di somiglianza tra i due tipi di supporti. La tabella seguente mostra i flag supportati.

Contrassegno Significato
AUDIOMEDIATYPE_EQUAL_FORMAT_TYPES I tipi di formato audio sono uguali.
AUDIOMEDIATYPE_EQUAL_FORMAT_DATA Le informazioni sul formato corrispondono, senza includere dati aggiuntivi oltre la struttura WAVEFORMATEX di base.
AUDIOMEDIATYPE_EQUAL_FORMAT_USER_DATA I dati aggiuntivi sono identici o nessun tipo di supporto contiene dati aggiuntivi.

Valore restituito

Il IsEqual metodo restituisce S_OK se ha esito positivo, in caso contrario restituisce uno dei valori HRESULT visualizzati nella tabella seguente.

Codice restituito Descrizione
E_INVALIDARG
 Un tipo di supporto non è valido o entrambi i tipi di supporti non sono validi.
S_FALSE
 I tipi di supporti non sono uguali. Esaminare il parametro pdwFlags per determinare il modo in cui i tipi di supporti differiscono.

Commenti

Entrambi i tipi di supporti devono avere un tipo principale, altrimenti il metodo restituisce E_INVALIDARG. Per altre informazioni sui tipi di supporti, vedere Tipi di supporti.

Il flag MF_MEDIATYPE_EQUAL_FORMAT_DATA indica che entrambi i tipi multimediali hanno attributi compatibili, anche se uno potrebbe essere un superset dell'altro. Questo metodo di confronto significa che è possibile confrontare un tipo di supporto parzialmente specificato rispetto a un tipo di supporto completo. Ad esempio, è possibile che siano presenti due tipi di video che descrivono lo stesso formato, ma un tipo include attributi per informazioni sul colore estese (chroma siting, intervallo nominale e così via).

Se il metodo ha esito positivo e tutti i flag di confronto vengono impostati in pdwFlags, il valore restituito è S_OK. Se il metodo ha esito positivo, ma alcuni flag di confronto non sono impostati, il metodo restituisce S_FALSE.

Requisiti

Requisito Valore
Client minimo supportato Disponibile in Windows Vista e versioni successive di Windows.
Piattaforma di destinazione Desktop
Intestazione audiomediatype.h (includere Audiomediatype.h)
IRQL Tutti i livelli.

Vedi anche

IAudioMediaType

Tipi di supporti

WAVEFORMATEX