IDirect3DDevice9Ex::CheckDeviceState 메서드(d3d9.h)

창 또는 전체 화면 애플리케이션에 대한 Direct3D 디바이스의 현재 협력 수준 상태 보고합니다.

구문

HRESULT CheckDeviceState(
  [in] HWND hDestinationWindow
);

매개 변수

[in] hDestinationWindow

형식: HWND

폐색을 위해 검사 대상 창 핸들입니다. 이 매개 변수가 NULL이면 다른 디바이스에 전체 화면 소유권이 있는 경우 S_PRESENT_OCCLUDED 반환됩니다. 창 핸들이 NULL이 아닌 경우 창의 클라이언트 영역에서 폐색이 확인됩니다. 창의 일부가 다른 애플리케이션에 의해 가려지면 창이 가려집니다.

반환 값

형식: HRESULT

가능한 반환 값은 D3D_OK, D3DERR_DEVICELOST, D3DERR_DEVICEHUNG, D3DERR_DEVICEREMOVED 또는 D3DERR_OUTOFVIDEOMEMORY( D3DERR 참조) 또는 S_PRESENT_MODE_CHANGED 또는 S_PRESENT_OCCLUDED( S_PRESENT 참조)입니다.

설명

이 메서드는 항상 Direct3D 9Ex 애플리케이션에서 S_OK 반환하는 IDirect3DDevice9::TestCooperativeLevel을 대체합니다.

모든 프레임에서 CheckDeviceState를 호출하지 않는 것이 좋습니다. 대신 IDirect3DDevice9Ex::P resentEx 메서드가 오류 코드를 반환하는 경우에만 CheckDeviceState를 호출합니다.

분실, 중단 및 제거된 디바이스에 대한 자세한 내용은 분실한 디바이스 동작 변경을 참조하세요.

요구 사항

대상 플랫폼	Windows
헤더	d3d9.h
라이브러리	D3D9.lib

추가 정보

IDirect3DDevice9Ex