Metodo IMFMediaType::GetRepresentation (mfobjects.h)

Articolo
03/15/2023

Recupera una rappresentazione alternativa del tipo di supporto. Attualmente è supportata solo la struttura di AM_MEDIA_TYPE DirectShow.

Sintassi

HRESULT GetRepresentation(
  [in]  GUID   guidRepresentation,
  [out] LPVOID *ppvRepresentation
);

Parametri

[in] guidRepresentation

GUID che specifica la rappresentazione da recuperare. Vengono definiti i valori seguenti.

Valore	Significato
AM_MEDIA_TYPE_REPRESENTATION	Convertire il tipo di supporto in una struttura AM_MEDIA_TYPE DirectShow. Il metodo seleziona la struttura di formato più appropriata (pbFormat).
FORMAT_MFVideoFormat	Convertire il tipo di supporto in una struttura AM_MEDIA_TYPE DirectShow con una struttura di formato MFVIDEOFORMAT .
FORMAT_VideoInfo	Convertire il tipo di supporto in una struttura AM_MEDIA_TYPE DirectShow con una struttura di formato VIDEOINFOHEADER .
FORMAT_VideoInfo2	Convertire il tipo di supporto in una struttura AM_MEDIA_TYPE DirectShow con una struttura di formato VIDEOINFOHEADER2 .

[out] ppvRepresentation

Riceve un puntatore a una struttura che contiene la rappresentazione. Il metodo alloca la memoria per la struttura. Il chiamante deve rilasciare la memoria chiamando IMFMediaType::FreeRepresentation.

Valore restituito

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

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
MF_E_ATTRIBUTENOTFOUND	I dettagli del tipo di supporto non corrispondono alla rappresentazione richiesta.
MF_E_INVALIDMEDIATYPE	Il tipo di supporto non è valido.
MF_E_UNSUPPORTED_REPRESENTATION	Il tipo di supporto non supporta la rappresentazione richiesta.

Commenti

Se si richiede una struttura di formato specifica nel parametro guidRepresentation , ad esempio VIDEOINFOHEADER, si potrebbero perdere alcune informazioni sul formato.

È anche possibile utilizzare la funzione MFInitAMMediaTypeFromMFMediaType per convertire un tipo di supporto media Foundation in un tipo di supporto DirectShow.

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

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

IMFMediaType

MFVIDEOFORMAT

Tipi di supporti

Condividi tramite