DXGKDDI_CREATECPUEVENT fonction de rappel (d3dkmddi.h)

  • Article

DXGKDDI_CREATECPUEVENT crée l’objet d’événement d’UC du pilote en mode noyau (KMD) pour l’objet Dxgkrnl correspondant.

Syntaxe

DXGKDDI_CREATECPUEVENT DxgkddiCreatecpuevent;

NTSTATUS DxgkddiCreatecpuevent(
  IN_CONST_HANDLE hAdapter,
  INOUT_PDXGKARG_CREATECPUEVENT pArgs
)
{...}

Paramètres

hAdapter

[in] Gérez dans un contexte KMD associé à une carte d’affichage. Le pilote miniport d’affichage a précédemment fourni cette poignée à Dxgkrnl dans le paramètre de sortie MiniportDeviceContext de la fonction DXGKDDI_ADD_DEVICE .

pArgs

[in/out] Pointeur vers une structure DXGKARG_CREATECPUEVENT avec des paramètres supplémentaires.

Valeur retournée

DXGKDDI_CREATECPUEVENT retourne STATUS_SUCCESS si elle réussit ; sinon, il retourne l’un des codes d’erreur définis dans Ntstatus.h.

Remarques

Les objets de synchronisation des événements du processeur KMD sont liés à un objet d’appareil (hKmdDevice). Lorsqu’un objet d’appareil est détruit, Dxgkrnl détruit tous les objets de synchronisation d’événements du processeur KMD associés en appelant DXGKDDI_DESTROYCPUEVENT.

KMD peut signaler l’événement en appelant DXGKCB_SIGNALEVENT et en fournissant le handle hDxgCpuEvent .

La durée de vie de l’objet d’événement du processeur ne dépend pas de la durée de vie de l’appareil de KMD ; autrement dit, l’objet peut être détruit après la destruction de l’appareil. hKmdDevice est transmis afin que le pilote puisse associer les objets de processus KMD (créés par DXGKDDI_CREATEPROCESS) à l’objet d’événement du processeur.

Pour plus d’informations, consultez Signalisation d’un événement d’UC à partir de KMD .

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 11 version 21H2 (WDDM 3.0)
En-tête d3dkmddi.h
IRQL PASSIVE_LEVEL

Voir aussi

DXGKARG_CREATECPUEVENT

DXGKDDI_DESTROYCPUEVENT