DXGKDDI_GETSTANDARDALLOCATIONDRIVERDATA fonction de rappel (d3dkmddi.h)

Article
11/11/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 d’affichage en mode noyau (KMD) a précédemment fourni ce handle pour Dxgkrnl dans sa fonction DxgkDdiAddDevice.

[in/out] pGetStandardAllocationDriverData

Pointeur vers une structureDXGKARG_GETSTANDARDALLOCATIONDRIVERDATA qui décrit une allocation standard.

Valeur de retour

DxgkDdiGetStandardAllocationDriverData retourne l’une des valeurs suivantes :

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

Remarques

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.

Dxgkrnl appelle la fonction DxgkDdiGetStandardAllocationDriverData DxgkDdiGetStandardAllocationDriverData pour générer une description du type d’allocation standard spécifié par le paramètre pGetStandardAllocationDriverData. KMD retourne la description du type d’allocation dans la pAllocationPrivateDriverData et pResourcePrivateDriverData membres de la structure DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA vers laquelle pointe le paramètre pGetStandardAllocationDriverData. Dxgkrnl passe par la suite la description à la fonction DxgkDdiCreateAllocation pour créer réellement l’allocation.

À compter de Windows 7, si KMD traite un appel à l'DxgkDdiGetStandardAllocationDriverData fonction pour créer des allocations pour l’accélération matérielle GDI, le pilote doit définir l’emplacement de l’allocation pour les allocations visibles par l’UC, **pGetStandardAllocationDriverData->pCreateGdiSurfaceData->**Pitch.

DxgkDdiGetStandardAllocationDriverData doit être rendu paginable.