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

Статья
02/06/2025

Запускает операцию декодирования видеотрансляций DirectX (DXVA), чтобы декодировать видеокадр.

Синтаксис

PFND3D11_1DDI_VIDEODECODERBEGINFRAME Pfnd3d111DdiVideodecoderbeginframe;

HRESULT Pfnd3d111DdiVideodecoderbeginframe(
  D3D10DDI_HDEVICE unnamedParam1,
  D3D11_1DDI_HDECODE unnamedParam2,
  const D3D11_1DDIARG_VIDEODECODERBEGINFRAME *unnamedParam3
)
{...}

Параметры

unnamedParam1

hDevice [in]

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

unnamedParam2

hDecoder [in]

Дескриптор для объекта декодирования видео, созданного с помощью вызова функции CreateVideoDecoder.

unnamedParam3

pBeginFrame [in]

Указатель на структуру D3D11_1DDIARG_VIDEODECODERBEGINFRAME. Дополнительные сведения см. в разделе "Примечания".

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

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

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

Замечания

Если VideoDecoderBeginFrame возвращает S_OK, среда выполнения Microsoft Direct3D вызывает функцию VideoDecoderSubmitBuffers для выполнения операций декодирования. При выполнении всех операций декодирования среда выполнения вызывает функцию VideoDecoderEndFrame, чтобы остановить операцию декодирования в кадре видео.

Примечание Каждый вызов VideoDecoderBeginFrame должен иметь соответствующий вызов VideoDecoderEndFrame, а вызовы VideoDecoderBeginFrame нельзя вложить.

Структура D3D11_1DDIARG_VIDEODECODERBEGINFRAME содержит следующие данные:

Ресурс, который получит расшифрованные и декодированные данные.
Ключ содержимого, используемый для шифрования данных видеокадров.
Если элемент pContentKey этой структуры не имеет значения NULL, буфер, на который ссылается этот элемент, содержит ключ содержимого каждого кадра. Этот ключ необходимо использовать для расшифровки данных вместо использования ключа сеанса.

Примечание Если элемент pContentKey не имеет значения NULL, буфер, на который ссылается этот элемент, шифруется с помощью ключа сеанса с алгоритмом AES-ECB.

Если для элемента pContentKey задано значение NULL, данные кадра видео должны расшифровывать с помощью ключа сеанса.

Требования

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

См. также

CreateVideoDecoder

VideoDecoderEndFrame

VideoDecoderSubmitBuffers

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