IToc::GetContext-Methode (wmcodecdsp.h)

  • Artikel

Die GetContext-Methode ruft einen Block von Bytes ab, der zuvor durch einen Aufruf von SetContext dem Inhaltsverzeichnis zugeordnet war.

Syntax

HRESULT GetContext(
  [in, out] DWORD *pdwContextSize,
  [out]     BYTE  *pbtContext
);

Parameter

[in, out] pdwContextSize

Wenn pbtContextNULL ist, ist dies ein Ausgabeparameter, der die Größe des Kontextblocks in Bytes empfängt. Wenn pbtContext nicht NULL ist, ist dies ein Eingabeparameter, der die Größe des vom Aufrufer zugewiesenen Puffers in Bytes angibt, auf den pbtContext verweist.

[out] pbtContext

NULL oder ein Zeiger auf einen vom Aufrufer zugewiesenen Puffer, der bei erfolgreicher Fertigstellung den Kontextblock empfängt.

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_BUFFERTOOSMALL
 Die Methode gibt diesen Fehlercode zurück, wenn pbtContext nicht NULL ist und der Kontextblock größer als die von bdwContextSize angegebene Größe ist. In diesem Fall dient pdwContextSize als Ausgabeparameter und empfängt die Größe des erforderlichen Puffers in Bytes.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile wmcodecdsp.h
DLL Wmvdspa.dll

Weitere Informationen

IToc