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

IPrintOemUni::EnablePDEV 메서드를 사용하면 Unidrv 대한 렌더링 플러그 인이 자체 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

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

cjGdiInfo

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

pGdiInfo

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

cjDevInfo

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

pDevInfo

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

pded

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

[out] pDevOem

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

반환 값

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

반환 코드	묘사
S_OK	작업이 성공했습니다.
E_FAIL	작업이 실패했습니다.

 

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

발언

Unidrv용 렌더링 플러그 인은 IPrintOemUni::EnablePDEV 메서드를 구현해야 합니다.

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

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

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

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

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

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

요구 사항

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