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 值，則必須將 allocation Count 成員設定為 零，並將 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，則陣列會包含單一元素，並接收下表所列的其中一個列舉值，以指出資源的落地狀態。 如果 hResourceNULL，陣列中的元素數目是由 AllocationCount 成員指定，而每個元素都會接收下列其中一個列舉值，以指出 phAllocationList 陣列中對應配置的落地狀態。

枚舉 數	意義
D3DKMT_ALLOCATIONRESIDENCYSTATUS_RESIDENTINGPUMEMORY （1）	資源或配置位於 GPU 記憶體中。
D3DKMT_ALLOCATIONRESIDENCYSTATUS_RESIDENTINSHAREDMEMORY （2）	資源或配置位於共用記憶體中。
D3DKMT_ALLOCATIONRESIDENCYSTATUS_NOTRESIDENT （3）	資源或配置不具資源性。

規格需求

需求	值
最低支援的用戶端	Windows Vista
標頭	d3dkmthk.h （包括 D3dkmthk.h）

另請參閱

D3DKMTQueryAllocationResidency