DXGKDDI_VALIDATESUBMITCOMMAND função de retorno de chamada (d3dkmddi.h)

Artigo
02/06/2025

A função DXGKDDI_VALIDATESUBMITCOMMAND do miniporto de exibição do modo kernel (KMD) valida os dados do driver privado que o DRIVER do modo de usuário (UMD) passa em chamadas para D3DKMTSubmitCommand ou D3DKMTSubmitCommandToHwQueue.

Sintaxe

DXGKDDI_VALIDATESUBMITCOMMAND DxgkddiValidatesubmitcommand;

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

Parâmetros

hContext

[in] Um identificador para o contexto do dispositivo de miniporto, que o KMD retornou de DxgkDdiAddDevice.

pArgs

[entrada/saída] Ponteiro para uma estrutura de DXGKARG_VALIDATESUBMITCOMMAND que contém informações necessárias para validar o comando de envio.

Valor de retorno

DXGKDDI_VALIDATESUBMITCOMMAND retorna um valor NTSTATUS, como um dos seguintes:

STATUS_SUCCESS
STATUS_INVALID_USER_BUFFER

Observações

Quando o KMD implementa esse retorno de chamada, o KMD sempre valida os dados privados passados em chamadas para:

DxgkDdiSubmitCommandVirtual
DxgkDdiSubmitCommandToHwQueue

Esse retorno de chamada é chamado somente quando o tamanho do driver privado (DmaBufferPrivateDataSize) no D3DKMTSubmitCommand não for zero.

Ele é chamado uma vez por D3DKMTSubmitCommand ou D3DKMTSubmitCommandToHwQueue .

O KMD não deve assumir que esse retorno de chamada é chamado no contexto do processo chamado D3DKMTSubmitCommand. Portanto, a UMD não deve passar ponteiros ou identificadores no modo de usuário em seus dados privados.

Esse retorno de chamada é chamado antes que o comando seja enviado para a fila de software do agendador de GPU para execução.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 10, versão 1809
cabeçalho	d3dkmddi.h
IRQL	PASSIVE_LEVEL

Consulte também

DXGKARG_VALIDATESUBMITCOMMAND

Partilhar via