IMFAttributes::GetAllocatedBlob Method
Retrieves a byte array associated with a key. This method allocates the memory for the array.
Syntax
HRESULT GetAllocatedBlob(
[in] REFGUID guidKey,
[out] UINT8 **ppBuf,
[out] UINT32 *pcbSize
);
Parameter
guidKey [in]
GUID that identifies which value to retrieve. The attribute type must be MF_ATTRIBUTE_BLOB.ppBuf [out]
If the key is found and the value is a byte array, this parameter receives a copy of the array. The caller must free the memory for the array by calling CoTaskMemFree.pcbSize [out]
Receives the size of the array, in bytes.
Rückgabewert
The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.
| Rückgabecode | Beschreibung |
|---|---|
| S_OK | The method succeeded. |
| MF_E_ATTRIBUTENOTFOUND | The specified key was not found. |
| MF_E_INVALIDTYPE | The attribute value is not a byte array. |
Hinweise
To copy a byte array value into a caller-allocated buffer, use the IMFAttributes::GetBlob method.
This interface is available on the following platforms if the Windows Media Format 11 SDK redistributable components are installed:
- Windows XP mit Service Pack 2 (SP2) und höher.
- Windows XP Media Center Edition 2005 with KB900325 (Windows XP Media Center Edition 2005) and KB925766 (Oktober 2006 Updaterollup für Windows XP Media Center Edition) installed.
Anforderungen
Mindestens unterstützter Client |
Windows Vista |
Mindestens unterstützter Server |
Windows Server 2008 |
Header |
Mfobjects.h (include Mfidl.h) |
Bibliothek |
Mfuuid.lib |