структура D3DDDICB_QUERYRESIDENCY (d3dumddi.h)
Структура D3DDDICB_QUERYRESIDENCY описывает состояние расположения ресурса или списка выделений.
Синтаксис
typedef struct _D3DDDICB_QUERYRESIDENCY {
[in] HANDLE hResource;
[in] UINT NumAllocations;
[in] const D3DKMT_HANDLE *HandleList;
[out] D3DDDI_RESIDENCYSTATUS *pResidencyStatus;
} D3DDDICB_QUERYRESIDENCY;
Члены
[in] hResource
Дескриптор ресурса, местонахождение которого запрашивается. Если драйвер отображения в пользовательском режиме использует массив в элементе handleList HandleList для запроса на размещение, он задает hResource значение NULL.
Если hResource неNULL, запрашиваются все выделения, принадлежащие ресурсу, и результат возвращается в первом элементе массива, на который pResidencyStatus. Состояние расположения ресурса равно самому низкому состоянию расположения всех выделений, принадлежащих ресурсу.
[in] NumAllocations
Количество выделений в массиве HandleList. Если драйвер отображения в пользовательском режиме задает дескриптор в элементе hResource неNULL, он должен задать значение NumAllocations нулю.
[in] HandleList
Массив D3DKMT_HANDLE типов данных, представляющих дескриптор режима ядра для выделения. Функция среды выполнения Microsoft Direct3D pfnAllocateC b возвращает эти дескриптора. Таким образом, драйвер отображения в пользовательском режиме использует эти дескрипторы для запроса на размещение.
Если драйвер отображения в пользовательском режиме задает дескриптор в элемент е hResource неNULL, он должен задать для HandleList значение NULL.
[out] pResidencyStatus
Указатель на массив значений D3DDDI_RESIDENCYSTATUS. Если элемент hResource не являетсяNULL, массив содержит один элемент и получает одно из следующих значений, чтобы указать состояние расположения ресурса. Если hResourceNULL, число элементов в массиве указывается элементом NumAllocations, а каждый элемент получает одно из следующих значений, чтобы указать состояние расположения соответствующего выделения в массиве, указанного HandleList.
| значение | значение |
|---|---|
| D3DDDI_RESIDENCYSTATUS_RESIDENTINGPUMEMORY (1) | Ресурс или список выделений находятся в памяти GPU, которая является самым высоким состоянием расположения. |
| D3DDDI_RESIDENCYSTATUS_RESIDENTINSHAREDMEMORY (2) | Ресурс или список выделений находятся в общей памяти. |
| D3DDDI_RESIDENCYSTATUS_NOTRESIDENT (3) | Ресурс или список выделений является нересидентным, что является самым низким состоянием расположения. |
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Доступно в Windows Vista и более поздних версиях операционных систем Windows. |
| заголовка | d3dumddi.h (include D3dumddi.h) |