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 成員中的陣列來查詢落地，則會 將 hResource 設定為 NULL。
如果 hResource 為非NULL，則會查詢屬於資源的所有配置，並在 pResidencyStatus 指向之陣的第一個元素中傳回結果。 資源的落地狀態等於屬於資源之所有配置的最低落地狀態。
[in] NumAllocations
HandleList 陣列中的配置數目。 如果使用者模式顯示驅動程式將 hResource 成員中的句柄設定為非NULL，則必須將 NumAllocations 設定為零。
[in] HandleList
D3DKMT_HANDLE數據類型的陣列，表示配置的核心模式句柄。 Microsoft Direct3D 運行時間 pfnAllocateCb 函式會傳回這些句柄。 因此，使用者模式顯示驅動程式會使用這些句柄來查詢落地。
如果使用者模式顯示驅動程式會將 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 （包括 D3dumddi.h） |