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 | pnEscapeCb는 플러그 앤 플레이(PnP) 중지 또는 TDR(시간 제한 검색 및 복구) 이벤트가 발생했기 때문에 디스플레이 미니포트 드라이버의 DxgkDdiEscape 함수에 대한 호출을 시작할 수 없습니다. pfnEscapeCb를 호출한 사용자 모드 표시 드라이버 함수는 이 오류 코드를 Direct3D 런타임으로 다시 반환해야 합니다. Direct3D 버전 9 참고: 오류 코드 반환에 대한 자세한 내용은 런타임 함수에서 받은 오류 코드 반환을 참조하세요. Direct3D 버전 10 및 11 참고: 드라이버 함수가 값을 반환하지 않는 경우(즉, 반환 매개 변수 형식에 대한 VOID가 있음) 드라이버 함수는 pfnSetErrorCb 함수를 호출하여 오류 코드를 런타임으로 다시 보냅니다. 오류 코드 처리에 대한 자세한 내용은 오류 처리를 참조하세요. |
이 함수는 다른 HRESULT 값을 반환할 수도 있습니다.
설명
사용자 모드 디스플레이 드라이버는 pfnEscapeCb 를 호출하여 다른 드라이버 통신에서 지원되지 않는 방식으로 디스플레이 미니포트 드라이버와 기타 정보를 공유합니다. 사용자 모드 디스플레이 드라이버는 디스플레이 미니포트 드라이버에 기타 정보를 보내거나 디스플레이 미니포트 드라이버에서 정보를 검색할 수 있습니다.
Direct3D 버전 11 참고: 드라이버가 pfnEscapeCb를 호출하는 방법에 대한 자세한 내용은 Direct3D 10에서 변경 내용을 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다. |
| 대상 플랫폼 | 데스크톱 |
| 머리글 | d3dumddi.h(D3dumddi.h 포함) |