Compartilhar via


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

A função de DXGKDDI_VALIDATESUBMITCOMMAND do miniporto de exibição do modo kernel (KMD) valida os dados do driver privado que o UMD (driver de modo de usuário) 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 as informações necessárias para validar o comando submit.

Retornar valor

DXGKDDI_VALIDATESUBMITCOMMAND retorna um valor NTSTATUS , como um dos seguintes:

  • STATUS_SUCCESS
  • STATUS_INVALID_USER_BUFFER

Comentários

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

Esse retorno de chamada é chamado somente quando o tamanho do driver privado (DmaBufferPrivateDataSize) em D3DKMTSubmitCommand não é 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 de 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
Cliente mínimo com suporte Windows 10, versão 1809
Cabeçalho d3dkmddi.h
IRQL PASSIVE_LEVEL

Confira também

DXGKARG_VALIDATESUBMITCOMMAND