структура DXGKARGCB_CREATECONTEXTALLOCATION (d3dkmddi.h)

Структура DXGKARGCB_CREATECONTEXTALLOCATION содержит атрибуты выделения контекста GPU или контекста для конкретного устройства, используемого в функции обратного вызова DXGKCB_CREATECONTEXTALLOCATION.

Синтаксис

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;

Члены

[in] ContextAllocationFlags

Структура DXGK_CREATECONTEXTALLOCATIONFLAGS, указывающая свойства выделения.

[in] hAdapter

Дескриптор графического адаптера, для которого создается выделение контекста.

[in] hDevice

Дескриптор устройства отображения, который изначально был передан подсистемой графики DirectX в функцию драйвера минипорта DxgkDdiCreateDevice.

[in] hContext

Если ContextAllocationFlags.SharedAcrossContexts имеет значение 0, этот элемент содержит значение, назначенное подсистемой графики DirectX для контекста, переданного функции DXGKCB_CREATECONTEXTALLOCATION.

Если ContextAllocationFlags.SharedAcrossContexts имеет значение 1, этот элемент должен иметь значение NULL.

[in] hDriverAllocation

Дескриптор, созданный драйвером мини-порта отображения, который определяет созданное выделение. Значение этого элемента впоследствии передается как элемент Transfer.hAllocation элемент структуры DXGKARG_BUILDPAGINGBUFFER, на который указывает параметр pBuildPagingBuffer функции DxgkDdiBuildPagingB uffer.

[in] Size

Размер в байтах, необходимый для выделения.

[in] Alignment

Необходимое выравнивание в байтах для выделения.

[in] SupportedSegmentSet

Идентификаторы сегментов, которые может задать драйвер мини-порта отображения в элементе PreferredSegment для операций чтения или записи.

[in] EvictionSegmentSet

Идентификаторы сегментов, которые можно использовать для вытеснения.

[in] PreferredSegment

Структура DXGK_SEGMENTPREFERENCE, указывающая предпочтительный идентификатор сегмента, запрашивающий драйвер минипорта отображения, который диспетчер памяти видео использует для выделения страницы.

[in] HintedBank

Структура DXGK_SEGMENTBANKPREFERENCE, указывающая параметры заказа банка, запрашивающие драйвер минипорта отображения, который диспетчер памяти видео использует для выделения на странице.

[in] Flags

Структура DXGK_ALLOCATIONINFOFLAGS, которая определяет свойства выделения в флагах битового поля. Эти свойства указывают тип создаваемого выделения. Драйвер минипорта отображения указывает эти флаги для диспетчера памяти видео. Сведения об ограничениях для значений флагов см. в примечаниях.

[out] hAllocation

Дескриптор, назначенный подсистемой графики DirectX для выделения. Это значение впоследствии передается в качестве параметра hAllocation функции DXGKCB_DESTROYCONTEXTALLOCATION.

[in] PhysicalAdapterIndex

Индекс физического адаптера. Это поле доступно начиная с WDDM 2.0.

Замечания

Драйвер мини-порта дисплея вызывает DXGKCB_CREATECONTEXTALLOCATION для выделения контекста GPU или контекста для конкретного устройства. Когда драйвер вызывает эту функцию, он передает указатель на структуру DXGKARGCB_CREATECONTEXTALLOCATION через параметр ContextAllocation.

Требования

См. также

DXGK_ALLOCATIONINFOFLAGS

DXGK_CREATECONTEXTALLOCATIONFLAGS

DXGK_SEGMENTBANKPREFERENCE

DXGK_SEGMENTPREFERENCE

DXGKCB_CREATECONTEXTALLOCATION

DXGKCB_DESTROYCONTEXTALLOCATION