DXGKCB_ACQUIREHANDLEDATA fonction de rappel (d3dkmddi.h)

Article
02/26/2024

DXGKCB_ACQUIREHANDLEDATA 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 DXGKCB_CREATECONTEXTALLOCATION.

[out] unnamedParam2

Pointeur vers un handle de mise en production pour le pilote à utiliser lors de la libération de la référence d’allocation.

Valeur retournée

Aucun.

Notes

Les handles d’allocation peuvent être détruits à tout moment par une application ou par un appel de pilote en mode utilisateur à D3DKMTDestroyAllocation sur un handle valide. La destruction de l’allocation implique une demande adressée au pilote en mode noyau pour supprimer l’objet d’allocation que Dxgkrnl lui a retourné 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. DXGKCB_ACQUIREHANDLEDATA et DXGKCB_RELEASEHANDLEDATA permettre au pilote de conserver une référence sur l’objet Dxgkrnl et de s’assurer que Dxgkrnl ne détruit pas l’allocation et les objets associés à KMD jusqu’à ce que l’appel de mise en production soit effectué.

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.