structure DXGKARGCB_CREATECONTEXTALLOCATION (d3dkmddi.h)

Article
02/06/2025

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 l’adaptateur graphique pour lequel l’allocation de contexte est créée.

[in] hDevice

Handle de l’appareil d’affichage qui a été passé à l’origine par le sous-système graphique DirectX au DxgkDdiCreateDevice du pilote d’affichage.

Note

Ce membre a la valeur 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 être défini sur NULL.

Note

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

[in] hDriverAllocation

Handle créé par le pilote miniport d’affichage qui identifie l’allocation créée. La valeur de ce membre est ensuite passée en tant que membre Transfer.hAllocation membre 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 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 miniport d’affichage demande au gestionnaire de mémoire vidéo d’utiliser pour la page dans l’allocation.

[in] HintedBank

Structure DXGK_SEGMENTBANKPREFERENCE qui indique les préférences de classement bancaire que le pilote miniport d’affichage demande au gestionnaire de mémoire vidéo d’utiliser pour la page de 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 miniport d’affichage spécifie ces indicateurs pour le gestionnaire de mémoire vidéo. Consultez remarques pour connaître les restrictions relatives aux 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 à l’appareil. Lorsque le pilote appelle cette fonction, il transmet un pointeur vers une structure DXGKARGCB_CREATECONTEXTALLOCATION via le paramètre ContextAllocation.