IPrintOemUI::QueryColorProfile method allows a user interface plug-in to specify an ICC profile to use for color management.
HRESULT QueryColorProfile( HANDLE hPrinter, POEMUIOBJ poemuiobj, PDEVMODE pPublicDM, PVOID pOEMDM, ULONG ulQueryMode, VOID *pvProfileData, ULONG *pcbProfileData, FLONG *pflProfileData );
Caller-supplied printer handle.
Caller-supplied pointer to an OEMUIOBJ structure.
Caller-supplied pointer to a validated DEVMODEW structure.
Caller-supplied pointer to the user interface plug-in's private DEVMODEW structure members.
One of the following caller-supplied bit flags, indicating the type of profile to be specified.
|QCP_DEVICEPROFILE||The caller is requesting a device profile.|
|QCP_SOURCEPROFILE||The caller is requesting a source profile.|
Caller-supplied pointer to a buffer to receive profile information.
Caller-supplied pointer to a value representing the size, in bytes, of the buffer pointed to by pvProfileData.
One of the following method-supplied bit flags, indicating the type of information the method is returning.
|QCP_PROFILEDISK||The method is returning the file name of an ICC profile in the buffer pointed to by pvProfileData.|
|QCP_PROFILEMEMORY||The method is returning profile data in the buffer pointed to by pvProfileData.|
The method must return one of the following values.
||The operation succeeded.|
||The operation failed.|
||The method is not implemented.|
A user interface plug-in's
IPrintOemUI::QueryColorProfile method performs the same types of operations as the DrvQueryColorProfile function that is exported by user-mode printer interface DLLs. For information about printer events and how they should be processed, see the description of the DrvQueryColorProfile function.
If you provide a user interface plug-in, the printer driver's DrvQueryColorProfile function calls the
IPrintOemUI::QueryColorProfile method. The DrvQueryColorProfile function performs its own processing for the specified event, and then calls the
IPrintOemUI::QueryColorProfile method to handle additional processing of the event.
IPrintOemUI::QueryColorProfile methods are exported by multiple user interface plug-ins, the methods are called in the order that the plug-ins are specified for installation.
For more information about creating and installing user interface plug-ins, see Customizing Microsoft's Printer Drivers.
|Header||prcomoem.h (include Prcomoem.h)|