IPrintOemUni::TTYGetInfo-Methode (prcomoem.h)

Mit der IPrintOemUni::TTYGetInfo-Methode kann ein Rendering-Plug-In Unidrv mit Informationen bereitstellen, die für nur Textdrucker relevant sind.

Syntax

HRESULT TTYGetInfo(
  PDEVOBJ pdevobj,
  DWORD   dwInfoIndex,
  PVOID   pOutputBuf,
  DWORD   dwSize,
  DWORD   *pcbcNeeded
);

Parameter

pdevobj

Vom Aufrufer bereitgestellter Zeiger auf eine DEVOBJ- Struktur.

dwInfoIndex

Vom Aufrufer bereitgestellte Konstante, die den angeforderten Informationstyp identifiziert. Die folgenden Konstantenwerte werden definiert:

OEMTTY_INFO_CODEPAGE

Der pOutputBuf Parameter verweist auf ein DWORD, in dem die Methode die Anzahl der zu verwendenden Codepage zurückgeben soll.

OEMTTY_INFO_MARGINS

Der pOutputBuf Parameter verweist auf eine RECT-Struktur, in der die Methode Seitenrandbreiten in zehntel Millimetern zurückgeben soll (z. B. 20 stellt 2 mm dar). Wenn die gesamte Seite druckbar ist, müssen alle Seitenrandwerte 0 sein.

OEMTTY_INFO_NUM_UFMS

Der pOutputBuf Parameter verweist auf ein DWORD, in dem die Methode die Anzahl der Ressourcen-IDs der UFMs für 10-, 12- und 17 CPI-Schriftarten zurückgeben soll. Um diese Ressourcen-IDs tatsächlich abzurufen, führen Sie eine Abfrage mit OEMTTY_INFO_UFM_IDS aus.

OEMTTY_INFO_UFM_IDS

Der pOutputBuf Parameter verweist auf ein Array von DWORDs mit ausreichender Größe, um die Anzahl der Ressourcen-IDs der UFMs für 10-, 12- und 17 CPI-Schriftarten zu enthalten. (Diese Zahl wird mithilfe von OEMTTY_INFO_NUM_UFMS in einer Abfrage abgerufen.) Die Methode sollte die Ressourcen-IDs der UFMs für 10.12- und 17 CPI-Schriftarten zurückgeben.

pOutputBuf

Vom Aufrufer bereitgestellter Zeiger auf einen Puffer, um die angeforderten Informationen zu empfangen.

dwSize

Vom Aufrufer bereitgestellte Größe des Puffers in Bytes, auf den pOutputBufverweist.

pcbcNeeded

Vom Aufrufer bereitgestellter Zeiger an eine Position, um die Anzahl der in den Puffer geschriebenen Bytes zu empfangen, auf die von pOutputBufverwiesen wird. Wenn die erforderliche Anzahl von Bytes kleiner als die von dwSizeangegebene Zahl ist, sollte die Methode die erforderliche Größe angeben und E_FAIL zurückgeben.

Rückgabewert

Die Methode muss einen der folgenden Werte zurückgeben.

Rückgabecode	Beschreibung
S_OK	Der Vorgang war erfolgreich.
E_FAIL	Fehler beim Vorgang.
E_NOTIMPL	Die Methode ist nicht implementiert.

Bemerkungen

Die IPrintOemUni::TTYGetInfo-Methode ist optional. Wenn ein Rendering-Plug-In diese Methode implementiert, muss die IPrintOemUni::GetImplementedMethod--Methode S_OK zurückgeben, wenn es "TTYGetInfo" als Eingabe empfängt.

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	prcomoem.h (einschließlich Prcomoem.h)