DXGKARG_OPENALLOCATION structure (d3dkmddi.h)

Article
02/26/2024

La structure DXGKARG_OPENALLOCATION décrit les allocations que le pilote de 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 les allocations à ouvrir.

[in] pPrivateDriverData

Pointeur vers un bloc de données privées qui est passé du pilote d’affichage en mode utilisateur au pilote miniport d’affichage. Ce bloc de données privées est le même que les données spécifiques à la ressource qui sont passées dans le membre pPrivateDriverData de la structure DXGKARG_CREATEALLOCATION dans l’appel à la fonction DxgkDdiCreateAllocation . Le pilote de 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

Pris en charge à partir de Windows 8.

Index dans la ressource pour la surface cible de rendu.

Le système d’exploitation spécifie ce membre uniquement si le pilote miniport d’affichage prend en charge l’accélération matérielle GDI. Plus précisément, le pilote de miniport d’affichage doit implémenter la fonction DxgkDdiRenderKm et doit créer l’appareil avec le membre GdiDevice 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

Pris en charge à partir de Windows 8.

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

[out] Pitch

Pris en charge à partir de Windows 8.

Pitch, en octets, de l’allocation, c’est-à-dire la distance, en octets, au début de la ligne suivante.