Metodo IMFMediaType::GetRepresentation (mfobjects.h)

  • Articolo

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