структура 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_CREATECONTEXTALLOCATIONFLAGS