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

Статья
02/06/2025

Функция минипорта в режиме ядра (KMD) DXGKDDI_VALIDATESUBMITCOMMAND проверяет данные частного драйвера, которые драйвер пользовательского режима (UMD) передает вызовы D3DKMTSubmitCommand или D3DKMTSubmitCommandToHwQueue.

Синтаксис

DXGKDDI_VALIDATESUBMITCOMMAND DxgkddiValidatesubmitcommand;

NTSTATUS DxgkddiValidatesubmitcommand(
  IN_CONST_HANDLE hContext,
  INOUT_PDXGKARG_VALIDATESUBMITCOMMAND pArgs
)
{...}

Параметры

hContext

[in] Дескриптор контекста минипорта устройства, который KMD вернулся из DxgkDdiAddDevice.

pArgs

[in/out] Указатель на структуру DXGKARG_VALIDATESUBMITCOMMAND, содержащую сведения, необходимые для проверки команды отправки.

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

DXGKDDI_VALIDATESUBMITCOMMAND возвращает значение NTSTATUS, например одно из следующих значений:

STATUS_SUCCESS
STATUS_INVALID_USER_BUFFER

Замечания

Когда KMD реализует этот обратный вызов, KMD всегда проверяет частные данные, передаваемые в вызовах:

Этот обратный вызов вызывается только в том случае, если размер частного драйвера (DmaBufferPrivateDataSize) в D3DKMTSubmitCommand не равен нулю.

Он вызывается один раз на D3DKMTSubmitCommand или D3DKMTSubmitCommandToHwQueue.

KmD не должен предполагать, что этот обратный вызов вызывается в контексте процесса, который называется D3DKMTSubmitCommand. Таким образом, UMD не должен передавать указатели в режиме пользователя или обрабатывать их в частных данных.

Этот обратный вызов вызывается перед отправкой команды в очередь программного обеспечения планировщика GPU для выполнения.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 10 версии 1809
заголовка	d3dkmddi.h
IRQL	PASSIVE_LEVEL

См. также

DXGKARG_VALIDATESUBMITCOMMAND

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