DXGKARGCB_CREATECONTEXTALLOCATION structure (d3dkmddi.h)

Article
08/07/2023

La structure DXGKARGCB_CREATECONTEXTALLOCATION contient les attributs d’allocation d’un contexte GPU ou d’un contexte spécifique à l’appareil utilisé dans la fonction de rappel DXGKCB_CREATECONTEXTALLOCATION .

Syntaxe

typedef struct _DXGKARGCB_CREATECONTEXTALLOCATION {
  [in]  DXGK_CREATECONTEXTALLOCATIONFLAGS ContextAllocationFlags;
  [in]  HANDLE                            hAdapter;
  [in]  HANDLE                            hDevice;
  [in]  HANDLE                            hContext;
  [in]  HANDLE                            hDriverAllocation;
  [in]  SIZE_T                            Size;
  [in]  UINT                              Alignment;
  [in]  UINT                              SupportedSegmentSet;
  [in]  UINT                              EvictionSegmentSet;
  [in]  DXGK_SEGMENTPREFERENCE            PreferredSegment;
  [in]  DXGK_SEGMENTBANKPREFERENCE        HintedBank;
  [in]  DXGK_ALLOCATIONINFOFLAGS          Flags;
  [out] HANDLE                            hAllocation;
  [in]  UINT                              PhysicalAdapterIndex;
} DXGKARGCB_CREATECONTEXTALLOCATION;

Membres

[in] ContextAllocationFlags

Structure DXGK_CREATECONTEXTALLOCATIONFLAGS qui spécifie les propriétés de l’allocation.

[in] hAdapter

Handle de la carte graphique pour laquelle l’allocation de contexte est créée.

[in] hDevice

Handle au périphérique d’affichage qui a été transmis à l’origine par le sous-système graphique DirectX à la fonction DxgkDdiCreateDevice du pilote miniport d’affichage.

Notes

Ce membre est défini sur NULL pour un appareil système.

[in] hContext

Si ContextAllocationFlags.SharedAcrossContexts a la valeur 0, ce membre contient la valeur affectée par le sous-système graphique DirectX pour le contexte passé à la fonction DXGKCB_CREATECONTEXTALLOCATION .

Si ContextAllocationFlags.SharedAcrossContexts a la valeur 1, ce membre doit avoir la valeur NULL.

Notes

Ce membre est également défini sur NULL pour un contexte système.

[in] hDriverAllocation

Handle créé par le pilote de miniport d’affichage qui identifie l’allocation créée. La valeur de ce membre est ensuite passée en tant que membre Transfer.hAllocation de la structure DXGKARG_BUILDPAGINGBUFFER pointée par le paramètre pBuildPagingBuffer de la fonction DxgkDdiBuildPagingBuffer .

[in] Size

Taille, en octets, requise pour l’allocation.

[in] Alignment

Alignement requis, en octets, pour l’allocation.

[in] SupportedSegmentSet

Identificateurs de segment que le pilote de miniport d’affichage peut définir dans le membre PreferredSegment pour les opérations de lecture ou d’écriture.

[in] EvictionSegmentSet

Identificateurs de segments qui peuvent être utilisés pour l’éviction.

[in] PreferredSegment

Structure DXGK_SEGMENTPREFERENCE qui indique les identificateurs de segment préférés que le pilote de miniport d’affichage demande que le gestionnaire de mémoire vidéo utilise pour paginer l’allocation.

[in] HintedBank

Une structure DXGK_SEGMENTBANKPREFERENCE qui indique les préférences de classement bancaire que le pilote de miniport d’affichage demande que le gestionnaire de mémoire vidéo utilise pour paginer l’allocation.

[in] Flags

Structure DXGK_ALLOCATIONINFOFLAGS qui identifie les propriétés d’une allocation dans les indicateurs de champ binaire. Ces propriétés indiquent le type d’allocation à créer. Le pilote de miniport d’affichage spécifie ces indicateurs pour le gestionnaire de mémoire vidéo. Consultez Remarques pour connaître les restrictions sur les valeurs d’indicateur.

[out] hAllocation

Handle qui a été affecté par le sous-système graphique DirectX à l’allocation. Cette valeur est ensuite passée en tant que paramètre hAllocation de la fonction DXGKCB_DESTROYCONTEXTALLOCATION .

[in] PhysicalAdapterIndex

Index de l’adaptateur physique. Ce champ est disponible à partir de WDDM 2.0.

Remarques

Le pilote miniport d’affichage appelle DXGKCB_CREATECONTEXTALLOCATION pour allouer un contexte GPU ou un contexte spécifique au périphérique. Lorsque le pilote appelle cette fonction, il passe un pointeur vers une structure DXGKARGCB_CREATECONTEXTALLOCATION via le paramètre ContextAllocation .