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 멤버를 0으로 설정하고 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 를 0으로 설정해야 합니다.

[out] pResidencyStatus

D3DKMT_ALLOCATIONRESIDENCYSTATUS 열거자의 배열에 대한 포인터입니다. hResource 멤버가 NULL이 아닌 경우 배열은 단일 요소를 포함하고 다음 표에 나열된 열거자 중 하나를 수신하여 리소스의 상주 상태 나타냅니다. hResource가 NULL인 경우 배열의 요소 수는 AllocationCount 멤버에 의해 지정되고 각 요소는 다음 열거자 중 하나를 수신하여 phAllocationList 배열에서 해당 할당의 상주 상태 나타냅니다.

Enumerator	의미
D3DKMT_ALLOCATIONRESIDENCYSTATUS_RESIDENTINGPUMEMORY (1)	리소스 또는 할당은 GPU 메모리에 상주합니다.
D3DKMT_ALLOCATIONRESIDENCYSTATUS_RESIDENTINSHAREDMEMORY (2)	리소스 또는 할당은 공유 메모리에 상주합니다.
D3DKMT_ALLOCATIONRESIDENCYSTATUS_NOTRESIDENT (3)	리소스 또는 할당이 비거주자입니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista
머리글	d3dkmthk.h(D3dkmthk.h 포함)

추가 정보

D3DKMTQueryAllocationResidency