структура D3DKMT_QUERYALLOCATIONRESIDENCY (d3dkmthk.h)

  • Статья

Структура D3DKMT_QUERYALLOCATIONRESIDENCY описывает сведения о получении статуса расположения из ресурса или списка выделений.

Синтаксис

typedef struct _D3DKMT_QUERYALLOCATIONRESIDENCY {
  [in]  D3DKMT_HANDLE                    hDevice;
  [in]  D3DKMT_HANDLE                    hResource;
  [in]  const D3DKMT_HANDLE              *phAllocationList;
  [in]  UINT                             AllocationCount;
  [out] D3DKMT_ALLOCATIONRESIDENCYSTATUS *pResidencyStatus;
} D3DKMT_QUERYALLOCATIONRESIDENCY;

Члены

[in] hDevice

D3DKMT_HANDLE тип данных, представляющий дескриптор режима ядра для устройства, с которым связан ресурс или список выделений.

[in] hResource

Дескриптор ресурса, место расположения которого запрашивается. Если OpenGL ICD использует массив, который указывает phAllocationList для запроса на место расположения, он присваивает hResourceзначение NULL. Если OpenGL ICD задает для hResource значение, отличное от NULL , он должен задать для элемента AllocationCount нулевое значение, а для phAllocationList — значение NULL.

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

Если какое-либо выделение, принадлежащее ресурсу, не является резидентом, весь ресурс считается не резидентом.

Чтобы получить подробные сведения о местонахождении каждого выделения, принадлежащего ресурсу, необходимо запросить выделение.

[in] phAllocationList

Массив D3DKMT_HANDLE типов данных, представляющих дескриптора в режиме ядра для выделений. OpenGL ICD использует эти дескрипторы для запроса состояния расположения.

Если OpenGL ICD задает для дескриптора в элементе hResource значение, отличное от NULL , для параметра phAllocationList необходимо задать значение NULL.

[in] AllocationCount

Количество выделений в массиве, указываемом phAllocationList . Если OpenGL ICD задает дескриптору в элементе hResource значение, отличное от NULL , значение AllocationCount должно быть равным нулю.

[out] pResidencyStatus

Указатель на массив D3DKMT_ALLOCATIONRESIDENCYSTATUS перечислителей. Если элемент hResource не равен NULL, массив содержит один элемент и получает один из перечислителей, перечисленных в следующей таблице, чтобы указать состояние расположения ресурса. Если параметр hResource имеет значение NULL, число элементов в массиве задается членом AllocationCount , и каждый элемент получает один из следующих перечислителей, чтобы указать состояние расположения соответствующего выделения в массиве phAllocationList .

Перечислитель Значение
D3DKMT_ALLOCATIONRESIDENCYSTATUS_RESIDENTINGPUMEMORY (1) Ресурс или выделение находятся в памяти GPU.
D3DKMT_ALLOCATIONRESIDENCYSTATUS_RESIDENTINSHAREDMEMORY (2) Ресурс или выделение находятся в общей памяти.
D3DKMT_ALLOCATIONRESIDENCYSTATUS_NOTRESIDENT (3) Ресурс или выделение не выполняется.

Требования

Требование Значение
Минимальная версия клиента Windows Vista
Верхняя часть d3dkmthk.h (включая D3dkmthk.h)

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

D3DKMTQueryAllocationResidency