다음을 통해 공유

IPrintOemUni::CommandCallback 메서드(prcomoem.h)

  • 아티클

IPrintOemUni::CommandCallback 메서드는 Unidrv 지원 프린터에 대해 동적으로 생성된 프린터 명령을 제공하는 데 사용됩니다.

통사론

HRESULT CommandCallback(
        PDEVOBJ pdevobj,
        DWORD   dwCallbackID,
        DWORD   dwCount,
        PDWORD  pdwParams,
  [out] OUT INT *piResult
);

매개 변수

pdevobj

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

dwCallbackID

프린터의 GPD 파일에서 프린터 명령의 *CallbackID 특성을 나타내는 호출자 제공 값입니다. (자세한 내용은 다음 주의 섹션을 참조하세요.)

dwCount

pdwParams가리키는 배열의 요소 수를 나타내는 호출자 제공 값입니다. 0일 수 있습니다.

pdwParams

프린터 명령 *Params 특성에 지정된 값을 포함하는 DWORD 크기의 매개 변수 배열에 대한 호출자 제공 포인터입니다. (자세한 내용은 다음 주의 섹션을 참조하세요.) NULL 수 있습니다.

[out] piResult

메서드 제공 결과 값을 받습니다. 다음 설명 섹션을 참조하세요.

반환 값

메서드는 다음 값 중 하나를 반환해야 합니다.

반환 코드 묘사
S_OK
 작업이 성공했습니다.
E_FAIL
 작업이 실패했습니다.
E_NOTIMPL
 메서드가 구현되지 않았습니다.

발언

IPrintOemUni::CommandCallback 메서드는 Unidrv지원되는 프린터의 경우 플러그 인을 렌더링하여 프린터 명령을 동적으로 생성하는 데 사용됩니다.

프린터 명령을 동적으로 생성하려면 *CallbackID 특성과 필요에 따라 *Params 특성을 프린터의 GPD 파일에 있는 명령의 *명령 항목 내에 포함해야 합니다. 자세한 내용은 동적으로 생성된 프린터 명령 참조하세요.

Unidrv는 IPrintOemUni::CommandCallback 메서드를 호출할 때 *명령 항목의 *CallbackID 특성 값을 dwCallbackID 매개 변수로 제공합니다. 또한 *명령 항목의 *Params 특성 값을 DWORD 배열 내에 배치하고 배열의 주소를 pParams 매개 변수로 제공합니다. 배열에는 값을 Unidrv 정의 표준 변수 집합이 포함되며, dwCount 매개 변수는 배열에 포함된 매개 변수 수를 지정합니다. 특성에 대한 자세한 내용은 명령 특성참조하세요.

메서드는 dwCallbackID 매개 변수 값을 사용하여 처리할 명령을 결정해야 합니다. 지원되는 각 명령에 대해 메서드는 *명령 항목의 *Params 특성에 의해 지정된 표준 변수와 순서를 알고 있어야 합니다.

이 메서드는 프린터 명령을 생성한 다음 IPrintOemDriverUni::D rvWriteSpoolBuf 메서드를 호출하여 인쇄 스풀러로 명령을 보냅니다.

메서드가 커서 명령을 처리하지 않는 한 piResult 제공된 값은 항상 0을 반환해야 합니다. x 또는 방향으로 커서를 이동하는 커서 명령의 경우 메서드는 새 커서 위치를 반환해야 합니다.

IPrintOemUni::CommandCallback 메서드는 선택 사항입니다. 렌더링 플러그 인이 이 메서드를 구현하는 경우 플러그 인의 IPrintOemUni::GetImplementedMethod 메서드는 "CommandCallback"을 입력으로 수신할 때 S_OK 반환해야 합니다.

요구 사항

요구 값
대상 플랫폼 바탕 화면
헤더 prcomoem.h(Prcomoem.h 포함)