DrvStartDoc 함수(winddi.h)

아티클
08/27/2023

DrvStartDoc 함수는 렌더링을 위해 드라이버에 문서 보내기를 시작할 준비가 되면 GDI에서 호출합니다.

구문

BOOL DrvStartDoc(
  [in] SURFOBJ *pso,
  [in] LPWSTR  pwszDocName,
  [in] DWORD   dwJobId
);

매개 변수

[in] pso

SURFOBJ 구조체에 대한 호출자 제공 포인터입니다.

[in] pwszDocName

인쇄할 문서의 이름을 지정하는 NULL로 끝나는 유니코드 문자열에 대한 호출자 제공 포인터입니다.

[in] dwJobId

호출자가 제공한 인쇄 작업 번호입니다. 이 값은 StartDocPrinter 호출의 스풀러에서 GDI로 반환됩니다.

반환 값

작업이 성공하면 함수는 TRUE를 반환해야 합니다. 그렇지 않으면 Win32 SetLastError 함수를 호출하여 오류 코드를 설정한 다음 FALSE를 반환해야 합니다.

설명

프린터 그래픽 DLL은DrvStartDoc 함수를 제공해야 합니다. 일반적으로 함수는 GDI의 EngWritePrinter 함수를 호출하여 문서를 인쇄하기 전에 프린터 하드웨어로 제어 시퀀스를 보내는 데 사용됩니다. 또한 이 함수는 프린터 그래픽 DLL에 대한 내부 문서별 초기화 작업을 수행할 수도 있습니다.

DrvStartDoc 함수는 인쇄 작업을 시작할 때 호출되며 애플리케이션(예: 인쇄 프로세서)이 ResetDC를 호출할 때마다 호출됩니다(DrvResetPDEV 참조). ResetDC에서 DrvStartDoc를 호출하면 pwszDocName 매개 변수가 NULL로 설정되고 dwJobId 매개 변수가 0으로 설정됩니다. 애플리케이션에서 호출이 오면 이러한 매개 변수는 각각 문서 이름 및 인쇄 작업 번호로 설정됩니다.

인쇄 작업이 시작될 때 프린터 그래픽 DLL에 대한 별도의 호출이 없기 때문에 DrvStartDoc 함수는 프린터에 필요한 경우 작업을 초기화하기 위해 프린터로 컨트롤 시퀀스를 보내야 합니다. 즉, 작업당 하나의 문서가 있습니다.