DrvDocumentPropertySheets 함수(winddiui.h)

  • 아티클

프린터 인터페이스 DLL의 DrvDocumentPropertySheets 함수는 인쇄 문서의 속성을 설명하는 속성 시트 페이지를 만드는 역할을 합니다.

구문

LONG DrvDocumentPropertySheets(
  [in, optional] PPROPSHEETUI_INFO pPSUIInfo,
                 LPARAM            lParam
);

매개 변수

[in, optional] pPSUIInfo

PROPSHEETUI_INFO 구조체에 대한 호출자 제공 포인터입니다. NULL일 수 있습니다(다음 설명 섹션 참조).

lParam

다음 표에 나와 있는 것처럼 PROPSHEETUI_INFO 구조체의 Reason 멤버 내용에 따라 달라지는 호출자 제공 정수 값입니다.

이유 값 lParam 정의
PROPSHEETUI_REASON_INIT DOCUMENTPROPERTYHEADER 구조체에 대한 포인터입니다.
기타 모든 이유 값 PFNPROPSHEETUI 함수 형식에 대한 lParam 매개 변수에 대한 설명을 참조하세요. DOCUMENTPROPERTYHEADER 구조체의 주소는 PROPSHEETUI_INFO 구조체의 lParamInit 멤버에 포함되어 있습니다.

반환 값

pPSUIInfo가 NULL이고 lParam -fMode가 0이거나 lParam ->>pdmOut이 NULL인 경우 이 함수는 프린터의 DEVMODEW 구조체의 크기를 바이트 단위로 반환해야 합니다. 그렇지 않으면 함수의 반환 값은 PFNPROPSHEETUI 함수 형식의 ReturnValue 섹션에 설명된 것과 동일합니다. 자세한 내용은 주의 섹션을 참조하세요.

설명

모든 프린터 인터페이스 DLL은 PFNPROPSHEETUI 함수 형식을 사용하여 정의된 DrvDocumentPropertySheets 함수를 제공해야 합니다. 함수의 목적은 CPSUI에서 제공하는 ComPropSheet 함수를 호출하여 인쇄 문서에 대한 사용자 수정 가능한 속성이 포함된 속성 시트 페이지를 지정하는 것입니다.

pPSUIInfo 매개 변수에 대해 받은 값이 NULL이 아닌 경우 NT 기반 운영 체제 인쇄 스풀러는 CPSUI를 통해 함수를 간접적으로 호출합니다. 다음 규칙이 적용됩니다.

  • 함수는 PFNPROPSHEETUI 함수 형식에 대해 설명된 대로 작업을 수행해야 합니다.

  • DOCUMENTPROPERTYHEADER 구조체의 fMode 멤버에 있는 플래그는 표시할 속성 시트 페이지와 사용자가 문서의 속성을 수정할 수 있는지 여부를 나타냅니다. 설정할 수 있는 유일한 플래그는 DM_IN_PROMPT(또는 DM_PROMPT), DM_ADVANCED, DM_NOPERMISSION 및 DM_OUT_BUFFER(또는 DM_COPY)입니다.

pPSUIInfo 매개 변수에 대해 받은 값이 NULL인 경우 인쇄 스풀러는 CPSUI를 거치지 않고 함수를 직접 호출합니다. 이 경우 lParam 매개 변수에는 DOCUMENTPROPERTYHEADER 구조체의 주소가 포함되며 다음 규칙이 적용됩니다.

  • DOCUMENTPROPERTYHEADER 구조체의 fMode 멤버가 0이거나 동일한 구조체의 pdmOut 멤버가 NULL인 경우 함수는 DOCUMENTPROPERTYHEADER 구조체의 cbOut 멤버에서 공용 및 프라이빗 구조체 멤버를 포함하여 프린터의 DEVMODEW 구조체의 총 크기만 반환해야 합니다.

  • DOCUMENTPROPERTYHEADER 구조체의 fMode 멤버가 0이 아닌 경우 함수는 fMode 플래그로 표시된 작업을 수행해야 합니다. 설정할 수 있는 유일한 플래그는 DM_IN_BUFFER(또는 DM_MODIFY) 및 DM_OUT_BUFFER(또는 DM_COPY)입니다.

요구 사항

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

추가 정보

DOCUMENTPROPERTYHEADER

DrvDevicePropertySheets

IPrintOemUI::D cumentPropertySheets