Метод IToc::GetContext (wmcodecdsp.h)

Статья
03/04/2024

Метод GetContext извлекает блок байтов, который ранее был связан с оглавлением, путем вызова Метода SetContext.

Синтаксис

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

Параметры

[in, out] pdwContextSize

Если pbtContext имеет значение NULL, это выходной параметр, который получает размер блока контекста в байтах. Если pbtContext не имеет значение NULL, это входной параметр, указывающий размер буфера, выделенного вызывающим объектом, в байтах, на который указывает pbtContext.

[out] pbtContext

NULL или указатель на буфер, выделенный вызывающим объектом, который при успешном завершении получает блок контекста.

Возвращаемое значение

Метод возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

Код возврата	Описание
S_OK	Метод выполнен успешно.
MF_E_BUFFERTOOSMALL	Метод возвращает этот код ошибки, если pbtContext не равно NULL , а блок контекста больше размера, заданного bdwContextSize. В этом случае pdwContextSize выступает в качестве выходного параметра и получает размер требуемого буфера в байтах.

Код возврата

Описание

S_OK

Метод выполнен успешно.

MF_E_BUFFERTOOSMALL

Метод возвращает этот код ошибки, если pbtContext не равно NULL , а блок контекста больше размера, заданного bdwContextSize. В этом случае pdwContextSize выступает в качестве выходного параметра и получает размер требуемого буфера в байтах.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	wmcodecdsp.h
DLL	Wmvdspa.dll

См. также раздел

IToc

Поделиться через