structure DXGKARG_OPENALLOCATION (d3dkmddi.h)

Article
02/06/2025

La structure DXGKARG_OPENALLOCATION décrit les allocations que le pilote miniport d’affichage doit ouvrir.

Syntaxe

typedef struct _DXGKARG_OPENALLOCATION {
  [in]     UINT                     NumAllocations;
  [in/out] DXGK_OPENALLOCATIONINFO  *pOpenAllocation;
  [in]     VOID                     *pPrivateDriverData;
  [in]     UINT                     PrivateDriverSize;
  [in]     DXGK_OPENALLOCATIONFLAGS Flags;
  [in]     UINT                     SubresourceIndex;
  [out]    SIZE_T                   SubresourceOffset;
  [out]    UINT                     Pitch;
} DXGKARG_OPENALLOCATION;

Membres

[in] NumAllocations

Nombre d’éléments dans le tableau spécifié par le membre pOpenAllocation, qui représente le nombre d’allocations spécifiques à l’appareil à ouvrir.

[in/out] pOpenAllocation

Tableau de structures DXGK_OPENALLOCATIONINFO pour que les allocations s’ouvrent.

[in] pPrivateDriverData

Pointeur vers un bloc de données privées transmis du pilote d’affichage en mode utilisateur au pilote miniport d’affichage. Ce bloc de données privées est les mêmes données spécifiques aux ressources transmises dans le membre pPrivateDriverData de la structure DXGKARG_CREATEALLOCATION dans l’appel à la fonction DxgkDdiCreateAllocation. Le pilote miniport d’affichage ne peut pas modifier ce bloc de données privées.

[in] PrivateDriverSize

Taille, en octets, du bloc de données privées vers lequel pPrivateDriverData pointe.

[in] Flags

Structure DXGK_OPENALLOCATIONFLAGS qui identifie l’opération à effectuer pour les allocations.

[in] SubresourceIndex

Prise en charge à partir de Windows 8.

Index dans la ressource pour l’aire cible de rendu.

Le système d’exploitation spécifie ce membre uniquement si le pilote miniport d’affichage prend en charge accélération matérielle GDI. Plus précisément, le pilote miniport d’affichage doit implémenter la fonction DxgkDdiRenderKm et doit créer l’appareil avec le GdiDevice membre défini dans DXGKARG_CREATEDEVICE.indicateurs.

Si la valeur de SubresourceIndex est supérieure au nombre de sous-ressources dans l’allocation, le pilote de miniport d’affichage doit retourner une erreur.

[out] SubresourceOffset

Prise en charge à partir de Windows 8.

Décalage, en octets, du début de l’allocation au début de la sous-source.

[out] Pitch

Prise en charge à partir de Windows 8.

Hauteur, en octets, de l’allocation, autrement dit la distance, en octets, au début de la ligne suivante.