Metodo IMFMediaType::IsEqual (mfobjects.h)

Articolo
08/24/2023

Confronta due tipi di supporti e determina se sono identici. Se non sono identici, il metodo indica come i due formati differiscono.

Sintassi

HRESULT IsEqual(
  [in]  IMFMediaType *pIMediaType,
  [out] DWORD        *pdwFlags
);

Parametri

[in] pIMediaType

Puntatore all'interfaccia IMFMediaType del tipo di supporto da confrontare.

[out] pdwFlags

Riceve un or bit per bit di zero o più flag, che indica il grado di somiglianza tra i due tipi di supporti. I flag seguenti sono definiti.

Valore	Significato
MF_MEDIATYPE_EQUAL_MAJOR_TYPES 0x00000001	I tipi principali sono gli stessi. Il tipo principale viene specificato dall'attributo MF_MT_MAJOR_TYPE .
MF_MEDIATYPE_EQUAL_FORMAT_TYPES 0x00000002	I sottotipi sono uguali o nessun tipo di supporto ha un sottotipo. Il sottotipo viene specificato dall'attributo MF_MT_SUBTYPE .
MF_MEDIATYPE_EQUAL_FORMAT_DATA 0x00000004	Gli attributi in uno dei tipi di supporti sono un subset degli attributi nell'altro e i valori di questi attributi corrispondono, escludendo il valore dell'MF_MT_USER_DATA , MF_MT_FRAME_RATE_RANGE_MIN e gli attributi MF_MT_FRAME_RATE_RANGE_MAX. In particolare, il metodo accetta il tipo di supporto con il numero minore di attributi e verifica se ogni attributo di tale tipo è presente nell'altro tipo di supporto e ha lo stesso valore (non incluso MF_MT_USER_DATA, MF_MT_FRAME_RATE_RANGE_MIN e MF_MT_FRAME_RATE_RANGE_MAX). Per eseguire altri confronti, usare il metodo FMAttributes::Compare . Ad esempio, il metodo Compare può testare gli attributi identici o testare l'intersezione dei due set di attributi. Per altre informazioni, vedere MF_ATTRIBUTES_MATCH_TYPE.
MF_MEDIATYPE_EQUAL_FORMAT_USER_DATA 0x00000008	I dati utente sono identici o nessun tipo di supporto contiene dati utente. I dati utente vengono specificati dall'attributo MF_MT_USER_DATA .

Valore restituito

Il metodo restituisce un HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice restituito	Descrizione
S_FALSE	I tipi non sono uguali. Esaminare il parametro pdwFlags per determinare il modo in cui i tipi differiscono.
S_OK	I tipi sono uguali.
E_INVALIDARG	Uno o entrambi i tipi di supporti non sono validi.

Commenti

Entrambi i tipi di supporti devono avere un tipo principale oppure il metodo restituisce E_INVALIDARG.

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 uno o più flag di confronto non sono impostati, il metodo restituisce S_FALSE.

Questa interfaccia è disponibile nelle piattaforme seguenti se i componenti ridistribuibili di Windows Media Format 11 SDK sono installati:

Windows XP con Service Pack 2 (SP2) e versioni successive.
Windows XP Media Center Edition 2005 con KB900325 (Windows XP Media Center Edition 2005) e KB925766 (aggiornamento cumulativo di ottobre 2006 per Windows XP Media Center Edition) installato.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	mfobjects.h (include Mfidl.h)
Libreria	Mfuuid.lib

Vedi anche

FMAttributes::Compare

IMFMediaType

Condividi tramite