Metodo IMFAttributes::GetAllocatedBlob (mfobjects.h)

Recupera una matrice di byte associata a una chiave. Questo metodo alloca la memoria per la matrice.

Sintassi

HRESULT GetAllocatedBlob(
  [in]  REFGUID guidKey,
  [out] UINT8   **ppBuf,
  [out] UINT32  *pcbSize
);

Parametri

[in] guidKey

GUID che identifica il valore da recuperare. Il tipo di attributo deve essere MF_ATTRIBUTE_BLOB.

[out] ppBuf

Se la chiave viene trovata e il valore è una matrice di byte, questo parametro riceve una copia della matrice. Il chiamante deve liberare la memoria per la matrice chiamando CoTaskMemFree.

[out] pcbSize

Riceve le dimensioni della matrice, in byte.

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	La chiave specificata non è stata trovata.
MF_E_INVALIDTYPE	Il valore dell'attributo non è una matrice di byte.

Commenti

Per copiare un valore di matrice di byte in un buffer allocato dal chiamante, usare il metodo IMFAttributes::GetBlob .

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

Attributi e proprietà

IMFAttributes

MF_ATTRIBUTE_TYPE