IPrintOemUni::TTYGetInfo-Methode (prcomoem.h)

Artikel
02/26/2024

Die IPrintOemUni::TTYGetInfo Methode ermöglicht es einem Rendering-Plug-In, Unidrv Informationen zur Verfügung zu stellen, die für reine 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 Typ der angeforderten Informationen 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 Zehntelmillimeter zurückgeben soll (z. B. 20 steht für 2 mm). Wenn die gesamte Seite druckbar ist, müssen alle Randwerte 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 aufzunehmen. (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, auf den pOutputBuf verweist, in Bytes.

pcbcNeeded

Vom Aufrufer bereitgestellter Zeiger auf einen Speicherort, an dem die Anzahl der Bytes empfangen werden soll, die in den Puffer geschrieben wurden, auf den pOutputBuf verweist. Wenn die anzahl der erforderlichen Bytes kleiner als die von dwSize angegebene 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 wurde erfolgreich ausgeführt.
E_FAIL	Fehler beim Vorgang.
E_NOTIMPL	Die Methode ist nicht implementiert.

Hinweise

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

Anforderungen

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

Freigeben über