структура 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 драйвера мини-порта дисплея.

Примечание

Для этого элемента задано значение NULL для системного устройства.

[in] hContext

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

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

Примечание

Этот элемент также имеет значение NULL для системного контекста.

[in] hDriverAllocation

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

[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 .

Требования

Требование Значение
Минимальная версия клиента Windows 8 (WDDM 1.2)
Минимальная версия сервера Windows Server 2012
Верхняя часть d3dkmddi.h (включая D3dkmddi.h)

См. также раздел

DXGK_ALLOCATIONINFOFLAGS

DXGK_CREATECONTEXTALLOCATIONFLAGS

DXGK_SEGMENTBANKPREFERENCE

DXGK_SEGMENTPREFERENCE

DXGKCB_CREATECONTEXTALLOCATION

DXGKCB_DESTROYCONTEXTALLOCATION