Поделиться через

структура 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. Если icD OpenGL задает дескриптор в элементе hResource значение, отличное отNULL, оно должно задать значение AllocationCount равным нулю.

[out] pResidencyStatus

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

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

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows Vista
заголовка d3dkmthk.h (include D3dkmthk.h)

См. также

D3DKMTQueryAllocationResidency