2.2.4.2.7 Server Document Properties Request (DOC_PROPERTIES_REQ)

When an application on a server invokes the document properties dialog box on the server side, a call to the printer driver results. A call for this scenario is redirected by this message.


0


1


2


3


4


5


6


7


8


9

1
0


1


2


3


4


5


6


7


8


9

2
0


1


2


3


4


5


6


7


8


9

3
0


1

Header (variable)

...

fMode

hServerWindow

...

cbDevmodeIn

DevmodeIn (variable)

...

OutputDevModeSizeProvided

Header (variable): The common message header (as specified in section 2.2.1). The InterfaceId field MUST be set to 0x00000000. The FunctionId field MUST be set to DOC_PROPERTIES_REQ (0x00000105).

fMode (4 bytes): A 32-bit unsigned integer. This field MUST identify the mode in which the server obtains document properties from the client printer driver; the server retrieves document properties for the specified mode only. The content of this field is generated by the printing subsystem and is treated as a payload in the Printer Driver Interface.

hServerWindow (8 bytes): A 64-bit unsigned integer. On the server side, when a call is made to a printer driver to show a document properties user interface (UI), it also specifies a WindowHandle to be used for parenting any UI that is displayed by the printer driver. The WindowHandle is passed in this field.

cbDevmodeIn (4 bytes): A 32-bit unsigned integer. The field MUST contain the number of bytes in the DevmodeIn field.

DevmodeIn (variable): An array of 8-bit unsigned integers. The content is generated by the printing subsystem and is treated as payload in the Printer Driver Interface.

OutputDevModeSizeProvided (4 bytes): A 32-bit unsigned integer. This field MUST contain the maximum number of bytes in the DevmodeOut field of the corresponding DOC_PROPERTIES_RSP response message to this request.