структура D3DDDICB_SETPRIORITY (d3dumddi.h)

Структура D3DDDICB_SETPRIORITY описывает уровень приоритета, для которого необходимо задать ресурс или список выделений.

Синтаксис

typedef struct _D3DDDICB_SETPRIORITY {
  [in] HANDLE              hResource;
  [in] UINT                NumAllocations;
  [in] const D3DKMT_HANDLE *HandleList;
  [in] const UINT          *pPriorities;
} D3DDDICB_SETPRIORITY;

Члены

[in] hResource

Дескриптор ресурса, приоритет которого должен быть задан. Если драйвер отображения пользовательского режима использует массив, указанный в HandleList , для установки приоритета для списка выделений, он устанавливает для hResourceзначение NULL. Если драйвер отображения пользовательского режима задает для hResource значение, отличное от NULL , он должен задать для элемента NumAllocations значение ноль, а для HandleList — значение NULL.

Если значение hResource не равно NULL, для всех выделений, принадлежащих ресурсу, устанавливается приоритет, заданный первым элементом массива, на который указывает pPriorities .

[in] NumAllocations

Количество выделений в массиве HandleList . Если драйвер отображения пользовательского режима задает дескриптор в элементе hResource значение, отличное от NULL , он должен присвоить NumAllocations значение нулю.

[in] HandleList

Массив D3DKMT_HANDLE типов данных, представляющих дескрипторы в режиме ядра для выделений. Функция pfnAllocateCb среды выполнения Microsoft Direct3D возвращает эти дескрипторы. Поэтому драйвер отображения пользовательского режима использует эти дескрипторы для установки приоритета для выделения.

Если драйвер отображения пользовательского режима задает дескриптор в элементе hResource значение, отличное от NULL , он должен задать для HandleList значение NULL.

[in] pPriorities

Указатель на массив уровней приоритета. Если элемент hResource не равен NULL, массив должен содержать один элемент. Если hResource имеет значение NULL, количество элементов в массиве задается элементом NumAllocations , а каждое выделение в массиве, заданном HandleList , устанавливается на уровень приоритета соответствующего элемента в pPriorities. Список определенных уровней приоритета см. в разделе Примечания на странице справочника по pfnSetPriorityCb .

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Windows Vista и более поздних версиях операционных систем Windows.
Верхняя часть	d3dumddi.h (включая D3dumddi.h)

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

pfnAllocateCb

pfnSetPriorityCb