IPrintOemUni::GetInfo method (prcomoem.h)

A rendering plug-in's IPrintOemUni::GetInfo method returns identification information.

Syntax

HRESULT GetInfo(
  DWORD  dwMode,
  PVOID  pBuffer,
  DWORD  cbSize,
  PDWORD pcbNeeded
);

Parameters

dwMode

Contains one of the following caller-supplied integer constants.

OEMGI_GETREQUESTEDHELPERINTERFACES

The method must write the bit flag value of OEMPUBLISH_IPRINTCOREHELPER to the buffer pBuffer if the IPrintOemUni::PublishDriverInterface method should be called with parameter pIUnknown pointing to an object that implements the IPrintCoreHelperUni Interface.

OEMGI_GETSIGNATURE

The method must return a unique four-byte identification signature. The plug-in must also place this signature in OPTITEM structures, as described in the description of the OEMCUIPPARAM. structure's pOEMOptItems member.

OEMGI_GETVERSION

The method must return the user interface plug-in's version number as a DWORD. The version format is developer-defined.

pBuffer

Caller-supplied pointer to memory allocated to receive the information specified by dwInfo.

cbSize

Caller-supplied size of the buffer pointed to by pBuffer.

pcbNeeded

Caller-supplied pointer to a location to receive the number of bytes written into the buffer pointed to by pBuffer.

Return value

The method must return one of the following values.

Return code Description
S_OK
The operation succeeded.
E_FAIL
The operation failed.

Remarks

A rendering plug-in for Unidrv must implement the IPrintOemUni::GetInfo method, which is called immediately after the plug-in is loaded. The method should return the specified information by writing it to the address specified by pBuffer and writing the size, in bytes, of the returned information into the location specified by pcbNeeded.

If pBuffer is NULL, the method should just use pcbNeeded to return the number of bytes required to store the specified information.

For more information about creating and installing rendering plug-ins, see Customizing Microsoft's Printer Drivers.

Requirements

Requirement Value
Target Platform Desktop
Header prcomoem.h (include Prcomoem.h)

See also

IPrintOemPS::GetInfo

IPrintOemUI::GetInfo

IPrintOemUni