IPrintOemUni::GetInfo-Methode (prcomoem.h)
Die IPrintOemUni::GetInfo Methode eines Rendering-Plug-Ins gibt Identifikationsinformationen zurück.
Syntax
HRESULT GetInfo(
DWORD dwMode,
PVOID pBuffer,
DWORD cbSize,
PDWORD pcbNeeded
);
Parameter
dwMode
Enthält eine der folgenden vom Aufrufer bereitgestellten ganzzahligen Konstanten.
OEMGI_GETREQUESTEDHELPERINTERFACES
Die Methode muss den Bitkennzeichnungswert von OEMPUBLISH_IPRINTCOREHELPER in den Puffer schreiben, pBuffer, wenn die IPrintOemUni::P ublishDriverInterface-Methode mit Parametern aufgerufen werden soll, pIUnknown auf ein Objekt zeigt, das die IPrintCoreHelperUni Interfaceimplementiert.
OEMGI_GETSIGNATURE
Die Methode muss eine eindeutige Vier-Byte-Identifikationssignatur zurückgeben. Das Plug-In muss diese Signatur auch in OPTITEM Strukturen platzieren, wie in der Beschreibung der OEMCUIPPARAMbeschrieben. die pOEMOptItems Member der Struktur.
OEMGI_GETVERSION
Die Methode muss die Versionsnummer des Plug-Ins der Benutzeroberfläche als DWORD zurückgeben. Das Versionsformat ist vom Entwickler definiert.
pBuffer
Vom Aufrufer bereitgestellter Zeiger auf den Speicher, der für den Empfang der durch dwInfoangegebenen Informationen zugewiesen wurde.
cbSize
Vom Aufrufer bereitgestellte Größe des Puffers, auf den pBuffer-verweist.
pcbNeeded
Vom Aufrufer bereitgestellter Zeiger auf eine Position, um die Anzahl der in den Puffer geschriebenen Bytes zu empfangen, auf die durch pBuffer-verwiesen wird.
Rückgabewert
Die Methode muss einen der folgenden Werte zurückgeben.
| Rückgabecode | Beschreibung |
|---|---|
|
Der Vorgang war erfolgreich. |
|
Fehler beim Vorgang. |
Bemerkungen
Ein Rendering-Plug-In für Unidrv muss die IPrintOemUni::GetInfo-Methode implementieren, die unmittelbar nach dem Laden des Plug-Ins aufgerufen wird. Die Methode sollte die angegebenen Informationen zurückgeben, indem sie in die durch pBuffer angegebene Adresse geschrieben und die Größe der zurückgegebenen Informationen in Byte in die durch pcbNeedededangegebene Position geschrieben.
Wenn pBuffer-NULL-ist, sollte die Methode nur pcbNeed verwenden, um die Anzahl der Bytes zurückzugeben, die zum Speichern der angegebenen Informationen erforderlich sind.
Weitere Informationen zum Erstellen und Installieren von Rendering-Plug-Ins finden Sie unter Anpassen der Druckertreiber von Microsoft.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Desktop |
| Header- | prcomoem.h (einschließlich Prcomoem.h) |