DXGKDDI_DESCRIBEALLOCATION fonction de rappel (d3dkmddi.h)

Article
02/23/2024

La fonction DxgkDdiDescribeAllocation récupère des informations sur une allocation existante qui n’est pas autrement disponible pour 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 paramètre de sortie MiniportDeviceContext de la fonction DxgkDdiAddDevice .

[in/out] pDescribeAllocation

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

Valeur retournée

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 gère pas nécessairement les enregistrements d’allocations, le sous-système du noyau graphique appelle DxgkDdiDescribeAllocation pour demander que le pilote de miniport d’affichage retourne des informations sur les allocations existantes. Actuellement, le pilote de miniport d’affichage doit être en mesure de retourner ces informations pour les allocations suivantes :

Allocations qui sont également des primaires (c’est-à-dire des allocations que le pilote d’affichage en mode utilisateur a créées en définissant l’indicateur de champ de bits principal dans le membre Indicateurs de la structure D3DDDI_ALLOCATIONINFO dans un appel à la fonction pfnAllocateCb ).
Allocations qui peuvent être la source d’une présentation (autrement dit, 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.