Share via


MFGetAttributeString-Funktion (mfapi.h)

Ruft einen Zeichenfolgenwert aus einem Attributspeicher ab.

Syntax

HRESULT MFGetAttributeString(
  [in]  IMFAttributes *pAttributes,
  [in]  REFGUID       guidKey,
  [out] PWSTR         *ppsz
);

Parameter

[in] pAttributes

Ein Zeiger auf die IMFAttributes-Schnittstelle .

[in] guidKey

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

[out] ppsz

Wenn der Schlüssel gefunden wird und der Wert ein Zeichenfolgentyp ist, empfängt dieser Parameter eine Kopie der Zeichenfolge. Der Aufrufer muss den Speicher für die Zeichenfolge durch Aufrufen von CoTaskMemFree freigeben.

Rückgabewert

Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Diese Funktion ist ein Wrapper für die IMFAttributes::GetAllocatedString-Methode .

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 8 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile mfapi.h

Weitere Informationen

Media Foundation-Funktionen