DXGKCB_ACQUIREHANDLEDATA fonction de rappel (d3dkmddi.h)

Article
02/06/2025

DxgkcbAcquirehandledata acquiert une référence à une allocation.

Syntaxe

DXGKCB_ACQUIREHANDLEDATA DxgkcbAcquirehandledata;

VOID * DxgkcbAcquirehandledata(
  [in]  IN_CONST_PDXGKARGCB_GETHANDLEDATA unnamedParam1,
  [out] PDXGKARG_RELEASE_HANDLE unnamedParam2
)
{...}

Paramètres

[in] unnamedParam1

Pointeur vers une structure DXGKARGCB_GETHANDLEDATA qui décrit un handle d’allocation retourné par DxgkcbCreatecontextallocation.

[out] unnamedParam2

Pointeur vers un handle de mise en production pour le pilote en mode noyau (KMD) pour gérer la durée de vie de la référence à l’allocation acquise. Le KMD utilise ce handle lorsqu’il appelle DxgkcbReleasehandledata pour libérer la référence d’allocation.

Valeur de retour

DxgkcbAcquirehandledata retourne un handle à l’allocation à laquelle le KMD a demandé une référence. Le kmD utilise ce handle pour les opérations suivantes sur l’allocation ou la ressource.

Remarques

Une application ou un pilote en mode utilisateur peut appeler D3DKMTDestroyAllocation à tout moment pour détruire un handle d’allocation. La destruction de l’allocation implique une demande adressée au KMD pour supprimer l’objet d’allocation qui Dxgkrnl retourné à eux lors de la création de l’allocation, de sorte que le KMD peut se retrouver avec un pointeur obsolète vers la mémoire libérée. DxgkcbAcquirehandledata et DxgkcbReleasehandledata autoriser le pilote à contenir une référence sur l’objet Dxgkrnl et à vérifier que Dxgkrnl ne détruit pas l’allocation et les objets associés à KMD jusqu’après l’appel de mise en production.

DXGKCB_XXX fonctions sont implémentées par Dxgkrnl. Pour utiliser cette fonction de rappel, définissez les membres de DXGKARGCB_GETHANDLEDATA, puis appelez DxgkCbAcquireHandleData via le DXGKRNL_INTERFACE.