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

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

[out] piResult

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

반환 값

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

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

설명

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

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

Unidrv가 메서드를 IPrintOemUni::CommandCallback 호출하면 *Command 항목의 *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 포함)