DrvDocumentPropertySheets-Funktion (winddiui.h)

Die Funktion "DrvDocumentPropertySheets " einer Druckerschnittstelle ist für das Erstellen von Eigenschaftenblattseiten verantwortlich, die die Eigenschaften eines Druckdokuments beschreiben.

Syntax

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

Parameter

[in, optional] pPSUIInfo

Aufrufer-bereitgestellter Zeiger auf eine PROPSHEETUI_INFO Struktur. Kann NULL sein (siehe den folgenden Abschnitt "Hinweise").

lParam

Aufrufer-bereitgestellter ganzzahliger Wert, der vom Inhalt des Grundelements der PROPSHEETUI_INFO-Struktur abhängig ist, wie in der folgenden Tabelle aufgeführt.

Grundwert Definition von lParam
PROPSHEETUI_REASON_INIT Zeiger auf eine DOCUMENTPROPERTYHEADER-Struktur .
Alle anderen Grundwerte Siehe die Beschreibung des lParam-Parameters für den PFNPROPSHEETUI-Funktionstyp .

(Die Adresse der DOCUMENTPROPERTYHEADER-Struktur ist im lParamInit-Element der PROPSHEETUI_INFO-Struktur enthalten.)

Rückgabewert

Wenn pPSUIInfoNULL ist, und wenn entweder lParam ->fMode null oder lParam -pdmOutNULL ist, sollte diese Funktion die Größe des Druckers in Bytes der DEVMODEW-Struktur> des Druckers zurückgeben. Andernfalls ist der Rückgabewert der Funktion identisch wie im Abschnitt "ReturnValue" des PFNPROPSHEETUI-Funktionstyps beschrieben. Weitere Informationen finden Sie im Abschnitt mit Hinweisen.

Bemerkungen

Alle Druckerschnittstellen-DLLs müssen eine DrvDocumentPropertySheets-Funktion bereitstellen, die mithilfe des PFNPROPSHEETUI-Funktionstyps definiert ist. Der Zweck der Funktion besteht darin, die Von CPSUI bereitgestellte ComPropSheet-Funktion aufzurufen, um Eigenschaftenblattseiten anzugeben, die benutzerveränderbare Eigenschaften für Druckdokumente enthalten.

Wenn der für den pPSUIInfo-Parameter empfangene Wert nicht NULL ist, ruft der NT-basierte Betriebssystemdruckspooler die Funktion indirekt über CPSUI auf. Es gelten die folgenden Regeln:

  • Die Funktion sollte Vorgänge ausführen, wie für den PFNPROPSHEETUI-Funktionstyp beschrieben.
  • Flags im fMode-Element der DOCUMENTPROPERTYHEADER-Struktur geben an, welche Eigenschaftenblattseiten angezeigt werden sollen und ob der Benutzer die Eigenschaften eines Dokuments ändern darf. Die einzigen Kennzeichen, die festgelegt werden können, sind DM_IN_PROMPT (oder DM_PROMPT), DM_ADVANCED, DM_NOPERMISSION und DM_OUT_BUFFER (oder DM_COPY).
Wenn der für den pPSUIInfo-Parameter empfangene Wert NULL ist, ruft der Druckspooler die Funktion direkt auf, ohne cpSUI zu durchlaufen. In diesem Fall enthält der lParam-Parameter die Adresse einer DOCUMENTPROPERTYHEADER-Struktur, und die folgenden Regeln gelten:
  • Wenn das fMode-Element der DOCUMENTPROPERTYHEADER-Struktur null ist oder das pdmOut-Element der gleichen Struktur NULL ist, sollte die Funktion nur die Gesamtgröße der DEVMODEW-Struktur des Druckers zurückgeben, einschließlich öffentlicher und privater Strukturmitglieder, im CBOut-Element der DOCUMENTPROPERTYHEADER-Struktur.
  • Wenn das fMode-Element der DOCUMENTPROPERTYHEADER-Struktur nicht null ist, sollte die Funktion die von den fMode-Flags angegebenen Vorgänge ausführen. Die einzigen Kennzeichen, die festgelegt werden können, sind DM_IN_BUFFER (oder DM_MODIFY), und DM_OUT_BUFFER (oder DM_COPY).

Anforderungen

   
Zielplattform Power BI Desktop
Header winddiui.h (einschließlich Winddiui.h)

Weitere Informationen

DOCUMENTPROPERTYHEADER

DrvDevicePropertySheets

IPrintOemUI::D ocumentPropertySheets