DocumentEvent 함수

DocumentEvent 함수는 문서 인쇄와 관련된 이벤트에 대한 이벤트 처리기입니다.

구문

HRESULT DocumentEvent(
  _In_  HANDLE hPrinter,
  _In_  HDC    hdc,
        INT    iEsc,
        ULONG  cbIn,
  _In_  PVOID  pvIn,
        ULONG  cbOut,
  _Out_ PVOID  pvOut
);

매개 변수

hPrinter [in]

프린터 개체에 대한 핸들입니다. OpenPrinter 또는 AddPrinter 함수를 사용하여 프린터 핸들을 검색합니다.

hdc [in]

CreateDC 호출에 의해 생성되는 디바이스 컨텍스트 핸들입니다. iEsc가 DOCUMENTEVENT_CREATEDCPRE 설정되면 0입니다. 64비트 버전의 Windows에서 32비트 애플리케이션에서 인쇄하는 제한 사항은 비고를 참조하세요.

iEsc

처리할 이벤트를 식별하는 이스케이프 코드입니다. 이 매개 변수는 다음 정수 상수 중 하나일 수 있습니다.

cbIn

pvIn에서 가리키는 버퍼의 크기(바이트)입니다.

pvIn [in]

버퍼에 대한 포인터입니다. 버퍼에 포함된 내용은 다음 표와 같이 iEsc 값에 따라 달라집니다.

cbOut

pvOut [out]

버퍼에 대한 포인터입니다. 버퍼의 내용은 다음 표와 같이 iEsc에 제공된 값에 따라 달라집니다.

반환 값

함수의 반환 값은 iEsc에 제공된 이스케이프에 따라 달라집니다. 일부 이스케이프 코드의 경우 반환 값이 사용되지 않습니다(아래 참조). 함수가 반환 값을 제공하는 경우 다음 중 하나여야 합니다.

다음 목록은 반환 값이 필요한 이스케이프 코드와 반환하지 않는 이스케이프 코드를 나타내며 DOCUMENTEVENT_SUCCESS, DOCUMENTEVENT_FAILURE 및 DOCUMENTEVENT_UNSUPPORTED 반환 코드의 의미를 설명합니다.

설명

DOCUMENTEVENT_QUERYFILTER iEsc 값의 경우 스풀러는 드라이버가 windows 드라이버 개발 키트에 설명된 DOCEVENT_FILTER 구조체의 특정 멤버를 수정했는지 여부에 따라 두 가지 방법으로 DocumentEvent에서 반환된 DOCUMENTEVENT_SUCCESS 값을 해석할 수 있습니다. (pvOut 매개 변수는 이 구조를 가리킵니다.) 스풀러는 이 형식의 구조체에 대한 메모리를 할당할 때 이 구조체의 두 멤버인 cElementsReturned 및 cElementsNeeded를 알려진 값으로 초기화합니다. DocumentEvent가 반환된 후 스풀러는 이러한 멤버의 값이 변경되었는지 여부를 확인하고 해당 정보를 사용하여 DocumentEvent 반환 값을 해석합니다. 다음 표에서는 이 상황을 요약합니다.

iEsc 매개 변수에 제공된 이스케이프 코드가 DOCUMENTEVENT_CREATEDCPRE 경우 다음 규칙이 적용됩니다.

• 작업이 스풀링 없이 프린터로 직접 전송되는 경우 pvIn-pszDevice>는 프린터 이름을 가리킵니다. (자세한 내용은 다음의 DOCEVENT_CREATEDCPRE 구조에 대한 설명서를 참조하세요.Windows 드라이버 개발 키트.)
• 작업이 스풀되는 경우 pvIn-pszDevice>는 프린터 포트 이름을 가리킵니다.

요구 사항

참고 항목

• 인쇄
• 인쇄 스풀러 API 함수
• Windows 드라이버 개발 키트