функция обратного вызова PFND3D11_1DDI_CREATEVIDEODECODER (d3d10umddi.h)

Статья
06.02.2025

Создает объект декодировщика видео.

Синтаксис

PFND3D11_1DDI_CREATEVIDEODECODER Pfnd3d111DdiCreatevideodecoder;

HRESULT Pfnd3d111DdiCreatevideodecoder(
  D3D10DDI_HDEVICE unnamedParam1,
  const D3D11_1DDIARG_CREATEVIDEODECODER *unnamedParam2,
  D3D11_1DDI_HDECODE unnamedParam3,
  D3D11_1DDI_HRTDECODE unnamedParam4
)
{...}

Параметры

unnamedParam1

hDevice [in]

Дескриптор устройства отображения (графический контекст).

unnamedParam2

pCreateData [in]

Указатель на структуру D3D11_1DDIARG_CREATEVIDEODECODER. Эта структура указывает атрибуты создаваемого объекта декодера видео.

unnamedParam3

hDecode [in]

Дескриптор частных данных драйвера для объекта декодера видео.

unnamedParam4

hRTDecode [in]

Дескриптор видео декодировщика, который драйвер должен использовать при вызове обратно в среду выполнения.

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

CreateVideoDecoder возвращает одно из следующих значений:

Возвращаемый код	Описание
S_OK	Объект декодировщика видео успешно создан.
D3DDDIERR_DEVICEREMOVED	Графический адаптер был удален.
E_OUTOFMEMORY	Память недоступна для завершения операции.

Замечания

Среда выполнения Microsoft Direct3D вызывает CreateVideoDecoder после вызова драйвера CalcPrivateVideoDecoderSize, чтобы определить размер в байтах для частных данных, необходимых драйверу для объекта декодировщика видео. Среда выполнения выделяет память для этих частных данных для драйвера. Драйвер использует эту память для хранения частных данных, связанных с объектом декодировщика видео.

Когда среда выполнения вызывает CreateVideoDecoder, она передает дескриптор в память частных данных в параметре hDecoder. Этот дескриптор фактически является указателем на память.

Драйвер должен отслеживать дескриптор на отображаемое устройство, которое использовалось для создания сеанса шифрования. Драйвер должен завершиться сбоем всех последующих вызовов, использующих этот созданный криптографический сеанс, например VideoDecoderBeginFrame, если отображаемое устройство, указанное в этих вызовах, отличается от устройства отображения, которое использовалось для создания декодировщика видео.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 8
минимальный поддерживаемый сервер	Windows Server 2012
целевая платформа	Настольный
заголовка	d3d10umddi.h (include D3d10umddi.h)