DXGKDDI_GETSTANDARDALLOCATIONDRIVERDATA fonction de rappel (d3dkmddi.h)

Article
02/23/2024

La fonction DxgkDdiGetStandardAllocationDriverData retourne une description d’un type d’allocation standard.

Syntaxe

DXGKDDI_GETSTANDARDALLOCATIONDRIVERDATA DxgkddiGetstandardallocationdriverdata;

NTSTATUS DxgkddiGetstandardallocationdriverdata(
  [in]     IN_CONST_HANDLE hAdapter,
  [in/out] INOUT_PDXGKARG_GETSTANDARDALLOCATIONDRIVERDATA pGetStandardAllocationDriverData
)
{...}

Paramètres

[in] hAdapter

Handle vers un bloc de contexte associé à un adaptateur d’affichage. Le pilote miniport d’affichage a précédemment fourni ce handle au sous-système du noyau graphique Microsoft DirectX dans le paramètre de sortie MiniportDeviceContext de la fonction DxgkDdiAddDevice .

[in/out] pGetStandardAllocationDriverData

Pointeur vers une structure DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA qui décrit une allocation standard.

Valeur retournée

DxgkDdiGetStandardAllocationDriverData retourne l’une des valeurs suivantes :

Code de retour	Description
STATUS_SUCCESS	DxgkDdiGetStandardAllocationDriverData a correctement retourné une description du type d’allocation standard.
STATUS_NO_MEMORY	DxgkDdiGetStandardAllocationDriverData n’a pas pu allouer la mémoire nécessaire pour qu’elle se termine.

Remarques

Les types d’allocation standard sont des allocations qui doivent être créées en mode noyau sans communication à partir du pilote d’affichage en mode utilisateur. Le sous-système du noyau graphique DirectX appelle la fonction DxgkDdiGetStandardAllocationDriverData pour générer une description du type d’allocation standard spécifié par le paramètre pGetStandardAllocationDriverData . Le pilote de miniport d’affichage retourne la description du type d’allocation dans les membres pAllocationPrivateDriverData et pResourcePrivateDriverData de la structure DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA vers laquelle pointe le paramètre pGetStandardAllocationDriverData . Le sous-système du noyau graphique DirectX transmet ensuite la description à la fonction DxgkDdiCreateAllocation pour créer réellement l’allocation.

À compter de Windows 7, si un pilote miniport d’affichage traite un appel à la fonction DxgkDdiGetStandardAllocationDriverData pour créer des allocations pour l’accélération matérielle GDI, le pilote doit définir l’argument d’allocation pour les allocations visibles du processeur, pGetStandardAllocationDriverData-pCreateGdiSurfaceData-Pitch>>.

DxgkDdiGetStandardAllocationDriverData doit être rendu paginable.