IPrintOemPS::EnablePDEV 메서드(prcomoem.h)

  • 아티클

메서드 IPrintOemPS::EnablePDEV 를 사용하면 Pscript5에 대한 렌더링 플러그 인이 자체 PDEV 구조를 만들 수 있습니다.

구문

HRESULT EnablePDEV(
        PDEVOBJ       pdevobj,
        PWSTR         pPrinterName,
        ULONG         cPatterns,
        HSURF         *phsurfPatterns,
        ULONG         cjGdiInfo,
        GDIINFO       *pGdiInfo,
        ULONG         cjDevInfo,
        DEVINFO       *pDevInfo,
        DRVENABLEDATA *pded,
  [out] OUT PDEVOEM   *pDevOem
);

매개 변수

pdevobj

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

pPrinterName

프린터의 논리적 주소를 나타내는 텍스트 문자열에 대한 호출자 제공 포인터입니다.

cPatterns

phsurfPatterns가 가리키는 버퍼에 포함된 HSURF 형식의 표면 핸들 수를 나타내는 호출자 제공 값입니다.

phsurfPatterns

HSURF 형식의 표면 핸들 의 cPatterns 수를 포함할 수 있을 만큼 큰 버퍼에 대한 호출자 제공 포인터입니다. 핸들은 표면 채우기 패턴을 나타냅니다.

cjGdiInfo

pGdiInfo가 가리키는 구조체의 크기를 나타내는 호출자 제공 값입니다.

pGdiInfo

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

cjDevInfo

pDevInfo가 가리키는 구조체의 크기를 나타내는 호출자 제공 값입니다.

pDevInfo

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

pded

프린터 드라이버의 그래픽 DDI 후킹 함수의 주소를 포함하는 DRVENABLEDATA 구조체에 대한 호출자 제공 포인터입니다. 자세한 내용은 아래 설명 부분을 참조하십시오.

[out] pDevOem

프라이빗 PDEV 구조에 대한 메서드 제공 포인터를 받습니다. (자세한 내용은 다음 설명 섹션을 참조하세요.)

반환 값

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

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

작업이 실패하면 메서드는 SetLastError 를 호출하여 오류 코드를 설정해야 합니다.

설명

메서드는 IPrintOemPS::EnablePDEV 프린터 그래픽 DLL에서 내보낸 DrvEnablePDEV 함수와 동일한 유형의 작업을 수행합니다. 그 목적은 렌더링 플러그 인이 자체 PDEV 구조를 만들 수 있도록하는 것입니다. (PDEV 구조체에 대한 자세한 내용은 사용자 지정된 PDEV 구조를 참조하세요.)

메서드를 내보내 IPrintOemPS::EnablePDEV 는 렌더링 플러그 인을 제공하는 경우 Pscript5의 프린터 그래픽 DLL은 DrvEnablePDEV 함수 내에서 메서드를 호출합니다.

메서드는 IPrintOemPS::EnablePDEV 프라이빗 PDEV 구조의 instance 할당하고 초기화한 다음 해당 주소를 메서드의 pDevOem 매개 변수로 반환해야 합니다. 다른 플러그 인 메서드는 주소를 DEVOBJ 구조의 pdevOEM 멤버로 받습니다.

DEVOBJ 구조체의 pdevOEM 멤버는 메서드와 함께 IPrintOemPS::EnablePDEV 사용되지 않습니다.

phsurfPatterns, pGdiInfo 및 pDevInfo 매개 변수 값이 가리키는 구조체는 Pscript5의 DrvEnablePDEV 함수가 받는 것과 동일합니다. 렌더링 플러그 인은 필요에 따라 구조체 콘텐츠를 수정할 수 있습니다. HSURF 형식의 표면 핸들을 가져와 phsurfPatterns가 가리키는 버퍼에 배치하여 표면 채우기 패턴을 제공할 수 있습니다. 채우기 패턴 형식 및 핸들 순서는 DrvEnablePDEV의 설명에 나열됩니다.

pded가 가리키는 DRVENABLEDATA 구조체에는 Pscript5의 프린터 그래픽 DLL에서 제공하는 그래픽 DDI 함수의 주소가 포함되어 있습니다. 이러한 그래픽 DDI 함수에 대한 플러그 인에서 사용자 지정된 후크 함수를 제공할 수 있습니다. DRVENABLEDATA 구조체의 내용을 사용하면 사용자 지정된 후크 함수가 드라이버의 그래픽 DDI 함수로 다시 호출할 수 있습니다. 자세한 내용은 사용자 지정된 그래픽 DDI 함수를 참조하세요.

요구 사항

요구 사항 값
대상 플랫폼 데스크톱
머리글 prcomoem.h(Prcomoem.h 포함)