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

추가 정보

DXGKARG_ESCAPE

DxgkDdiAddDevice

pfnEscapeCb