DXGKDDI_VALIDATESUBMITCOMMAND fonction de rappel (d3dkmddi.h)

  • Article

La fonction de DXGKDDI_VALIDATESUBMITCOMMAND du miniport d’affichage en mode noyau (KMD) valide les données de pilote privé que le pilote en mode utilisateur (UMD) transmet dans les appels à D3DKMTSubmitCommand ou D3DKMTSubmitCommandToHwQueue.

Syntaxe

DXGKDDI_VALIDATESUBMITCOMMAND DxgkddiValidatesubmitcommand;

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

Paramètres

hContext

[in] Handle vers le contexte de l’appareil miniport, que le KMD a retourné à partir de DxgkDdiAddDevice.

pArgs

[entrée/sortie] Pointeur vers une structure DXGKARG_VALIDATESUBMITCOMMAND contenant les informations nécessaires pour valider la commande d’envoi.

Valeur retournée

DXGKDDI_VALIDATESUBMITCOMMAND retourne une valeur NTSTATUS telle que l’une des valeurs suivantes :

  • STATUS_SUCCESS
  • STATUS_INVALID_USER_BUFFER

Remarques

Lorsque le KMD implémente ce rappel, le KMD valide toujours les données privées passées dans les appels à :

Ce rappel est appelé uniquement lorsque la taille du pilote privé (DmaBufferPrivateDataSize) dans D3DKMTSubmitCommand n’est pas égale à zéro.

Elle est appelée une fois par D3DKMTSubmitCommand ou D3DKMTSubmitCommandToHwQueue.

Le KMD ne doit pas supposer que ce rappel est appelé dans le contexte du processus qui a appelé D3DKMTSubmitCommand. Par conséquent, l’UMD ne doit pas passer de pointeurs ou de handles en mode utilisateur dans ses données privées.

Ce rappel est appelé avant que la commande ne soit envoyée à la file d’attente logicielle du planificateur GPU pour exécution.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10, version 1809
En-tête d3dkmddi.h
IRQL PASSIVE_LEVEL

Voir aussi

DXGKARG_VALIDATESUBMITCOMMAND