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 배열에서 해당 할당의 상주 상태를 나타내기 위해 다음 열거자 중 하나를 받습니다.

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

요구 사항

요구	값
지원되는 최소 클라이언트	Windows Vista
헤더	d3dkmthk.h(D3dkmthk.h 포함)

참고 항목

D3DKMTQueryAllocationResidency