The driver sends this message when it starts to print a new document.
Parameters:
wParam:
A handle to the TSPrnMessage structure. Use the GlobalLock WinAPI function to get a pointer to a TSPrnMessage structure:
TSPrnMessage* pPrnMsg = (TSPrnMessage*)GlobalLock((HGLOBAL)wParam);
If you do not need the TSPrnMessage structure anymore, free it using the GlobalUnlock and GlobalFree functions:
GlobalUnlock((HGLOBAL)wParam);
GlobalFree((HGLOBAL)wParam);
The definition of the TSPrnStructure is available on the following page: http://www.blackice.com/private/rtk/The_Message_Capture_Library_Reference.htm
For printer drivers 14.97 and earlier, the valid members of the TSPrnMessage structure for the “BLACKICE_MESSAGE_STARTDOC” messages are dwMessage, szDocName, szPrinterName, fAppendPage, fPortrait and the szFileName members. The szFileName member contains the name of the group file.
For printer drivers 14.98 and newer, the valid members of the TSPrnMessage structure for the “BLACKICE_MESSAGE_STARTDOC” messages are dwMessage, szDocName, szPrinterName, fAppendPage, fPortrait, dwJobID, szFileName and szGroupFileName members. The szFileName member contains the name of the group file and is available for compatibility with older applications. To get the group file name, use the szGroupFileName member instead.
lParam:
Not used.