IMFAttributes::GetAllocatedBlob-Methode (mfobjects.h)

  • Artikel

Ruft ein Bytearray ab, das einem Schlüssel zugeordnet ist. Diese Methode weist den Arbeitsspeicher für das Array zu.

Syntax

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

Parameter

[in] guidKey

GUID, die den abzurufenden Wert identifiziert. Der Attributtyp muss MF_ATTRIBUTE_BLOB sein.

[out] ppBuf

Wenn der Schlüssel gefunden wird und der Wert ein Bytearray ist, empfängt dieser Parameter eine Kopie des Arrays. Der Aufrufer muss den Arbeitsspeicher für das Array durch Aufrufen von CoTaskMemFree freigeben.

[out] pcbSize

Empfängt die Größe des Arrays in Bytes.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode BESCHREIBUNG
S_OK
 Die Methode wurde erfolgreich ausgeführt.
MF_E_ATTRIBUTENOTFOUND
 Der angegebene Schlüssel wurde nicht gefunden.
MF_E_INVALIDTYPE
 Der Attributwert ist kein Bytearray.

Hinweise

Um einen Bytearraywert in einen vom Aufrufer zugewiesenen Puffer zu kopieren, verwenden Sie die IMFAttributes::GetBlob-Methode .

Diese Schnittstelle ist auf den folgenden Plattformen verfügbar, wenn die verteilbaren Windows Media Format 11 SDK-Komponenten installiert sind:

  • Windows XP mit Service Pack 2 (SP2) und höher.
  • Windows XP Media Center Edition 2005 mit KB900325 (Windows XP Media Center Edition 2005) und KB925766 (Updaterollup für Windows XP Media Center Edition vom Oktober 2006) installiert.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile mfobjects.h (include Mfidl.h)
Bibliothek Mfuuid.lib

Weitere Informationen

Attribute und Eigenschaften

IMFAttributes

MF_ATTRIBUTE_TYPE