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 포함)

추가 정보

pfnQueryResidencyCb