PFND3DDDI_ESCAPECB 콜백 함수(d3dumddi.h)

pfnEscapeCb 콜백 함수는 디스플레이 미니포트 드라이버와 정보를 공유합니다.

구문

PFND3DDDI_ESCAPECB Pfnd3dddiEscapecb;

HRESULT Pfnd3dddiEscapecb(
  HANDLE hAdapter,
  const D3DDDICB_ESCAPE *unnamedParam2
)
{...}

매개 변수

hAdapter

그래픽 어댑터 개체에 대한 핸들입니다.

unnamedParam2

pData [in, out]

공유 정보를 설명하는 D3DDDICB_ESCAPE 구조체에 대한 포인터입니다.

반환 값

pfnEscapeCb 는 다음 값 중 하나를 반환합니다.

반환 코드 설명
S_OK 정보가 성공적으로 공유되었습니다.
E_OUTOFMEMORY 메모리가 부족하여 pfnEscapeCb를 완료할 수 없습니다.
E_INVALIDARG 매개 변수의 유효성이 검사되었고 잘못된 것으로 확인되었습니다.
D3DDDIERR_DEVICEREMOVED pnP(플러그 앤 플레이) 중지 또는 TDR(시간 제한 검색 및 복구) 이벤트가 발생했기 때문에 pfnEscapeCb에서 디스플레이 미니포트 드라이버의 DxgkDdiEscape 함수에 대한 호출을 시작할 수 없습니다. pfnEscapeCb를 호출하는 사용자 모드 표시 드라이버 함수는 이 오류 코드를 Direct3D 런타임으로 다시 반환해야 합니다.
Direct3D 버전 9 참고: 오류 코드 반환에 대한 자세한 내용은 런타임 함수에서 받은 오류 코드 반환을 참조하세요.
Direct3D 버전 10 및 11 참고: 드라이버 함수가 값을 반환하지 않는 경우(즉, 반환 매개 변수 형식에 대한 VOID가 있음) 드라이버 함수 는 pfnSetErrorCb 함수를 호출하여 오류 코드를 런타임으로 다시 보냅니다. 오류 코드 처리에 대한 자세한 내용은 오류 처리를 참조하세요.

이 함수는 다른 HRESULT 값을 반환할 수도 있습니다.

설명

사용자 모드 디스플레이 드라이버는 pfnEscapeCb 를 호출하여 다른 드라이버 통신에서 지원되지 않는 방식으로 디스플레이 미니포트 드라이버와 기타 정보를 공유합니다. 사용자 모드 디스플레이 드라이버는 디스플레이 미니포트 드라이버에 기타 정보를 보내거나 디스플레이 미니포트 드라이버에서 정보를 검색할 수 있습니다.

Direct3D 버전 11 참고: 드라이버가 pfnEscapeCb를 호출하는 방법에 대한 자세한 내용은 Direct3D 10의 변경 내용을 참조하세요.

요구 사항

   
지원되는 최소 클라이언트 Windows Vista 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다.
대상 플랫폼 데스크톱
헤더 d3dumddi.h(D3dumddi.h 포함)

참고 항목

D3DDDICB_ESCAPE

D3DDDI_DEVICECALLBACKS

DxgkDdiEscape