IPrintOemUni::GetInfo-Methode (prcomoem.h)

  • Artikel

Die Methode eines Rendering-Plug-Ins gibt Identifikationsinformationen IPrintOemUni::GetInfo 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 Bitflagwert von OEMPUBLISH_IPRINTCOREHELPER in den Puffer pBuffer schreiben, wenn die IPrintOemUni::P ublishDriverInterface-Methode mit dem Parameter pIUnknown aufgerufen werden soll, der auf ein Objekt verweist, das die IPrintCoreHelperUni-Schnittstelle implementiert.

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 des OEMCUIPPARAM beschrieben. pOEMOptItems-Element der -Struktur.

OEMGI_GETVERSION

Die -Methode muss die Versionsnummer des Benutzeroberflächen-Plug-Ins als DWORD zurückgeben. Das Versionsformat ist vom Entwickler definiert.

pBuffer

Vom Aufrufer bereitgestellter Zeiger auf den Speicher, der für den Empfang der von dwInfo angegebenen Informationen zugeordnet ist.

cbSize

Vom Aufrufer bereitgestellte Größe des Puffers, auf den pBuffer verweist.

pcbNeeded

Vom Aufrufer bereitgestellter Zeiger auf einen Speicherort, an dem die Anzahl der Bytes empfangen werden soll, die von pBuffer in den Puffer geschrieben werden.

Rückgabewert

Die -Methode muss einen der folgenden Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
 Der Vorgang wurde erfolgreich ausgeführt.
E_FAIL
 Fehler beim Vorgang.

Hinweise

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 sie an die von pBuffer angegebene Adresse schreibt und die Größe der zurückgegebenen Informationen in Byte an den von pcbNeeded angegebenen Speicherort schreibt.

Wenn pBufferNULL ist, sollte die Methode einfach pcbNeeded 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
Kopfzeile prcomoem.h (include Prcomoem.h)

Weitere Informationen

IPrintOemPS::GetInfo

IPrintOemUI::GetInfo

IPrintOemUni