D3DKMTInvalidateActiveVidPn 함수(d3dkmthk.h)
D3DKMTInvalidateActiveVidPn 함수는 현재 사용 중인 VidPN(현재 비디오 제공 네트워크)을 무효화합니다.
참고
이 함수는 Windows 7 이상 버전의 Windows 운영 체제에서 사용되지 않습니다.
구문
NTSTATUS D3DKMTInvalidateActiveVidPn(
[in] const D3DKMT_INVALIDATEACTIVEVIDPN *unnamedParam1
);
매개 변수
[in] unnamedParam1
현재 사용 중인 활성 VidPN을 무효화하는 매개 변수를 설명하는 D3DKMT_INVALIDATEACTIVEVIDPN 구조체에 대한 포인터입니다.
반환 값
D3DKMTInvalidateActiveVidPn은 다음 값 중 하나를 반환합니다.
| 반환 코드 | 설명 |
|---|---|
| STATUS_SUCCESS | 현재 사용 중인 VidPN이 성공적으로 무효화되었습니다. |
| STATUS_GRAPHICS_INVALID_DISPLAY_ADAPTER | VidPN을 무효화하기 위해 D3DKMT_INVALIDATEACTIVEVIDPN hAdapter 멤버에 그래픽 어댑터가 지정되지 않았습니다. |
| STATUS_NO_MEMORY | 메모리가 부족하여 D3DKMTInvalidateActiveVidPn을 완료할 수 없습니다. |
| STATUS_NOT_SUPPORTED | D3DKMT_INVALIDATEACTIVEVIDPN pPrivateDriverData 멤버가 가리키는 버퍼의 OpenGL ICD(설치 가능 클라이언트 드라이버)에서 요청한 디스플레이 모드는 디스플레이 미니포트 드라이버에서 지원되지 않습니다. 이 상태 값은 windows 7 이상을 실행하는 컴퓨터에서 이 함수가 DXGKDDI_INTERFACE_VERSION = DXGKDDI_INTERFACE_VERSION_WIN7 >있는 디스플레이 미니포트 드라이버에 의해 호출되는 경우에도 반환됩니다. |
| STATUS_DEVICE_REMOVED | 그래픽 어댑터가 중지되었습니다. |
| STATUS_GRAPHICS_NO_RECOMMENDED_FUNCTIONAL_VIDPN | 디스플레이 미니포트 드라이버는 현재 사용 중인 VidPN을 대체하기 위해 VidPN을 권장하지 않았습니다. |
이 함수는 다른 NTSTATUS 값을 반환할 수도 있습니다.
설명
현재 사용 중인 VidPN을 무효화하기 위해 D3DKMTInvalidateActiveVidPn 함수를 호출하면 현재 VidPN이 디스플레이 미니포트 드라이버에서 권장하는 새 VidPN으로 바뀝니다. 디스플레이 미니포트 드라이버는 새 VidPN을 권장해야 하므로 디스플레이 미니포트 드라이버는 D3DKMT_INVALIDATEACTIVEVIDPN pPrivateDriverData 멤버가 가리키는 버퍼에서 OpenGL ICD에 필요한 디스플레이 모드를 확인할 수 있어야 합니다.
OpenGL ICD는 D3DKMTSetDisplayMode 함수에 대한 보다 일반적인 호출을 사용하여 지원되지 않는 디스플레이 모드(예: 클론 보기 모드)에 대해 D3DKMTInvalidateActiveVidPn을 호출할 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | 버전 DXGKDDI_INTERFACE_VERSION_WIN7 있는 디스플레이 미니포트 드라이버를 위해 Windows Vista 이상 버전의 < Windows 운영 체제에서 사용할 수 있습니다. |
| 대상 플랫폼 | 유니버설 |
| 헤더 | d3dkmthk.h(D3dkmthk.h 포함) |
| 라이브러리 | Gdi32.lib |
| DLL | Gdi32.dll |