DXGKDDI_DESCRIBEALLOCATION fonction de rappel (d3dkmddi.h)

Article
02/06/2025

La fonction DxgkDdiDescribeAllocation récupère des informations sur une allocation existante qui n’est pas disponible dans le sous-système du noyau graphique Microsoft DirectX.

Syntaxe

DXGKDDI_DESCRIBEALLOCATION DxgkddiDescribeallocation;

NTSTATUS DxgkddiDescribeallocation(
  [in]     IN_CONST_HANDLE hAdapter,
  [in/out] INOUT_PDXGKARG_DESCRIBEALLOCATION pDescribeAllocation
)
{...}

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 DirectX dans le MiniportDeviceContext paramètre de sortie de la fonction DxgkDdiAddDevice.

[in/out] pDescribeAllocation

Pointeur vers une structure DXGKARG_DESCRIBEALLOCATION qui décrit une allocation existante.

Valeur de retour

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

Remarques

Étant donné que le sous-système du noyau graphique DirectX ne conserve pas nécessairement les enregistrements d’allocations, le sous-système du noyau graphique appelle DxgkDdiDescribeAllocation pour demander que le pilote miniport d’affichage retourne des informations sur les allocations existantes. Actuellement, le pilote miniport d’affichage doit être en mesure de retourner ces informations pour les allocations suivantes :

Les allocations qui sont également primaires (c’est-à-dire les allocations créées par le pilote d’affichage en mode utilisateur en définissant l’indicateur de champ principal principal dans les indicateurs de membre de la structure de D3DDDI_ALLOCATIONINFO dans un appel à la fonction pfnAllocateCb).
Allocations qui peuvent être la source d’une présentation (c’est-à-dire les allocations représentées par le membre hSource de la structure DXGKARG_PRESENT dans un appel à la fonction DxgkDdiPresent du pilote de miniport d’affichage).

DxgkDdiDescribeAllocation doit être rendu paginable.