Metodo IAudioMediaType::IsEqual (audiomediatype.h)

Articolo
02/23/2024

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

Condividi tramite