DXGKDDI_ESCAPE 콜백 함수(d3dkmddi.h)
DxgkDdiEscape 함수는 사용자 모드 디스플레이 드라이버와 정보를 공유합니다.
구문
DXGKDDI_ESCAPE DxgkddiEscape;
NTSTATUS DxgkddiEscape(
[in] IN_CONST_HANDLE hAdapter,
[in] IN_CONST_PDXGKARG_ESCAPE pEscape
)
{...}
매개 변수
[in] hAdapter
디스플레이 어댑터와 연결된 컨텍스트 블록에 대한 핸들입니다. 디스플레이 미니포트 드라이버는 이전에 DxgkDdiAddDevice 함수의 MiniportDeviceContext 출력 매개 변수에서 Microsoft DirectX 그래픽 커널 하위 시스템에 이 핸들을 제공했습니다.
[in] pEscape
공유 정보에 대한 정보를 포함하는 DXGKARG_ESCAPE 구조체에 대한 포인터입니다.
참고 두 번째 수준에서 DxgkDdiEscape 호출을 만들려면 DXGKARG_ESCAPE 멤버인 D3DDDI_ESCAPEFLAGS 구조 내에서 HardwareAccess 플래그를 설정해야 합니다. 이 플래그를 설정하지 않으면 호출이 실패합니다.
반환 값
DxgkDdiEscape 는 다음 값 중 하나를 반환합니다.
| 반환 코드 | 설명 |
|---|---|
| STATUS_SUCCESS | DxgkDdiEscape에서 정보를 공유했습니다. |
| STATUS_INVALID_PARAMETER | DxgkDdiEscape에 전달된 매개 변수에는 완료되지 않는 오류가 포함되어 있습니다. |
| STATUS_NO_MEMORY | DxgkDdiEscape가 완료하는 데 필요한 메모리를 할당할 수 없습니다. |
| STATUS_PRIVILEGED_INSTRUCTION | DxgkDdiEscape는 권한이 없는 명령(즉, 현재 중앙 처리 장치 [CPU] 프로세스의 권한을 초과하여 메모리에 액세스하는 명령)을 검색했습니다. |
| STATUS_ILLEGAL_INSTRUCTION | DxgkDdiEscape는 그래픽 하드웨어에서 지원할 수 없는 지침을 검색했습니다. |
| STATUS_GRAPHICS_DRIVER_MISMATCH | 디스플레이 미니포트 드라이버는 DxgkDdiEscape에 대한 호출을 시작한 사용자 모드 디스플레이 드라이버와 호환되지 않습니다. |
설명
DirectX 그래픽 커널 하위 시스템은 사용자 모드 디스플레이 드라이버가 다른 드라이버 통신을 통해 지원되지 않는 방식으로 디스플레이 미니포트 드라이버와 정보를 공유해야 할 때마다 디스플레이 미니포트 드라이버의 DxgkDdiEscape 함수를 호출합니다.
DxgkDdiEscape 를 페이징 가능으로 만들어야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista |
| 대상 플랫폼 | 데스크톱 |
| 머리글 | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |