Méthode IMFAttributes ::GetAllocatedBlob (mfobjects.h)
Récupère un tableau d’octets associé à une clé. Cette méthode alloue la mémoire pour le tableau.
Syntaxe
HRESULT GetAllocatedBlob(
[in] REFGUID guidKey,
[out] UINT8 **ppBuf,
[out] UINT32 *pcbSize
);
Paramètres
[in] guidKey
GUID qui identifie la valeur à récupérer. Le type d’attribut doit être MF_ATTRIBUTE_BLOB.
[out] ppBuf
Si la clé est trouvée et que la valeur est un tableau d’octets, ce paramètre reçoit une copie du tableau. L’appelant doit libérer la mémoire du tableau en appelant CoTaskMemFree.
[out] pcbSize
Reçoit la taille du tableau, en octets.
Valeur retournée
Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.
| Code de retour | Description |
|---|---|
|
S_OK |
|
La clé spécifiée est introuvable. |
|
La valeur de l’attribut n’est pas un tableau d’octets. |
Remarques
Pour copier une valeur de tableau d’octets dans une mémoire tampon allouée par l’appelant, utilisez la méthode IMFAttributes ::GetBlob .
Cette interface est disponible sur les plateformes suivantes si les composants redistribuables du SDK Windows Media Format 11 sont installés :
- Windows XP avec Service Pack 2 (SP2) et versions ultérieures.
- Windows XP Media Center Edition 2005 avec KB900325 (Windows XP Media Center Edition 2005) et KB925766 (correctif cumulatif d’octobre 2006 pour Windows XP Media Center Edition) installés.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista [applications de bureau | applications UWP] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau | applications UWP] |
| Plateforme cible | Windows |
| En-tête | mfobjects.h (include Mfidl.h) |
| Bibliothèque | Mfuuid.lib |