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 를 0으로 설정해야 합니다.
[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 포함) |