이스케이프 함수(wingdi.h)

아티클
03/08/2023

Escape 함수를 사용하면 애플리케이션이 GDI를 통해 사용할 수 없는 시스템 정의 디바이스 기능에 액세스할 수 있습니다. 애플리케이션에서 수행한 이스케이프 호출이 변환되어 드라이버로 전송됩니다.

구문

int Escape(
  [in]  HDC    hdc,
  [in]  int    iEscape,
  [in]  int    cjIn,
  [in]  LPCSTR pvIn,
  [out] LPVOID pvOut
);

매개 변수

[in] hdc

디바이스 컨텍스트에 대한 핸들입니다.

[in] iEscape

수행할 이스케이프 함수입니다. 이 매개 변수는 설명에 나열된 미리 정의된 이스케이프 값 중 하나여야 합니다. 애플리케이션이 프라이빗 이스케이프 값을 정의하는 경우 ExtEscape 함수를 사용합니다.

[in] cjIn

lpvInData 매개 변수가 가리키는 데이터 바이트 수입니다. 0일 수 있습니다.

[in] pvIn

지정된 이스케이프에 필요한 입력 구조체에 대한 포인터입니다.

[out] pvOut

이 이스케이프에서 출력을 받는 구조체에 대한 포인터입니다. 데이터가 반환되지 않으면 이 매개 변수는 NULL 이어야 합니다.

반환 값

함수가 성공하면 구현만 확인하는 QUERYESCSUPPORT 프린터 이스케이프를 제외하고 반환 값이 0보다 큽니다. 이스케이프가 구현되지 않은 경우 반환 값은 0입니다.

함수가 실패하면 반환 값은 시스템 오류 코드입니다.

설명

참고 이는 차단 또는 동기 함수이며 즉시 반환되지 않을 수 있습니다. 이 함수가 얼마나 빨리 반환되는지는 네트워크 상태, 인쇄 서버 구성 및 프린터 드라이버 구현과 같은 런타임 요인(애플리케이션을 작성할 때 예측하기 어려운 요소)에 따라 달라집니다. 사용자 인터페이스와의 상호 작용을 관리하는 스레드에서 이 함수를 호출하면 애플리케이션이 응답하지 않는 것처럼 보일 수 있습니다.

cbInput에 대해 0을 전달하는 효과는 nEscape의 값과 이스케이프를 처리하는 드라이버에 따라 달라집니다.

원본 프린터 이스케이프 중에서 다음만 사용할 수 있습니다.

이스케이프	설명
QUERYESCSUPPORT	디바이스 드라이버에서 특정 이스케이프를 구현하는지 여부를 결정합니다.
통과	애플리케이션에서 프린터로 직접 데이터를 보낼 수 있습니다.

프린터 이스케이프에 대한 자세한 내용은 ExtEscape를 참조하세요.

StartPage 함수를 사용하여 프린터 드라이버가 데이터를 받을 수 있도록 준비합니다.

요구 사항


지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	wingdi.h(Windows.h 포함)
라이브러리	Gdi32.lib
DLL	Gdi32.dll