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경우 리소스에 속한 모든 할당이 쿼리되고 pResidencyStat us가 가리키는 배열의 첫 번째 요소에서 결과가 반환됩니다. 리소스의 상주 상태는 리소스에 속하는 모든 할당의 가장 낮은 상주 상태와 같습니다.
[in] NumAllocations
HandleList 배열의 할당 수입니다. 사용자 모드 표시 드라이버가 hResource 멤버의 핸들을 비NULL설정하는 경우 NumAllocations 설정해야 합니다.
[in] HandleList
할당에 대한 커널 모드 핸들을 나타내는 D3DKMT_HANDLE 데이터 형식의 배열입니다. Microsoft Direct3D 런타임의 pfnAllocateCb 함수는 이러한 핸들을 반환합니다. 따라서 사용자 모드 표시 드라이버는 이러한 핸들을 사용하여 상주 쿼리를 합니다.
사용자 모드 표시 드라이버가 hResource 멤버의 핸들을 비NULL설정하는 경우 HandleList NULL 설정해야 합니다.
[out] pResidencyStatus
D3DDDI_RESIDENCYSTATUS 값 배열에 대한 포인터입니다. hResource 멤버가 비-NULL경우 배열은 단일 요소를 포함하고 다음 값 중 하나를 수신하여 리소스의 상주 상태를 나타냅니다. hResource NULL 경우 배열의 요소 수는 NumAllocations 멤버에 의해 지정되고 각 요소는 HandleList지정된 배열에서 해당 할당의 상주 상태를 나타내기 위해 다음 값 중 하나를 받습니다.
| 값 | 의미 |
|---|---|
| D3DDDI_RESIDENCYSTATUS_RESIDENTINGPUMEMORY (1) | 리소스 또는 할당 목록은 가장 높은 상주 상태인 GPU 메모리에 상주합니다. |
| D3DDDI_RESIDENCYSTATUS_RESIDENTINSHAREDMEMORY (2) | 리소스 또는 할당 목록은 공유 메모리에 상주합니다. |
| D3DDDI_RESIDENCYSTATUS_NOTRESIDENT (3) | 리소스 또는 할당 목록은 가장 낮은 상주 상태인 비거주자입니다. |
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다. |
| 헤더 | d3dumddi.h(D3dumddi.h 포함) |