IPrintCoreUI2::QuerySimulationSupport-Methode (prcomoem.h)

Artikel
02/07/2025

Die IPrintCoreUI2::QuerySimulationSupport-Methode ruft eine Spoolersimulationsfunktionsstruktur ab, die die Arten der Simulation angibt, die der Spooler unterstützt.

Syntax

HRESULT QuerySimulationSupport(
  [in]  HANDLE hPrinter,
  [in]  DWORD  dwLevel,
  [out] PBYTE  pCaps,
  [in]  DWORD  cbSize,
  [out] PDWORD pcbNeeded
);

Parameter

[in] hPrinter

Gibt einen Ziehpunkt für den Drucker an.

[in] dwLevel

Gibt die im Puffer zurückgegebene Spoolersimulationsfunktionsstruktur an, auf die von pCapsverwiesen wird. Derzeit wird nur Stufe 1 der Spoolersimulation unterstützt.

Wert	Unterstützungsstruktur der Spoolersimulation
1	SIMULATE_CAPS_1 (definiert in printoem.h)

[out] pCaps

Zeiger auf den Ausgabepuffer, der eine Struktur des Typs enthält, der durch den Wert im dwLevel Parameter angegeben ist.

[in] cbSize

Gibt die Größe des Ausgabepuffers in Bytes an, auf die durch pCaps-verwiesen wird.

[out] pcbNeeded

Gibt die Größe des Speichers in Bytes an, der zum Speichern einer Struktur des typs erforderlich ist, der durch dwLevel-angegeben wird.

Rückgabewert

Die Methode muss einen der folgenden Werte zurückgeben.

Rückgabecode	Beschreibung
S_OK	Die Methode war erfolgreich.
E_OUTOFMEMORY	Der Wert in cbSize war kleiner als die Anzahl der Bytes, die in den Ausgabepuffer geschrieben werden sollen (der Puffer, auf den pCapsverweist). Die Methode wurde aufgerufen, wobei pCaps auf NULL-festgelegt wurde.
E_NOTIMPL	Die Methode wird nicht unterstützt. Eine Struktur des durch dwLevel- angegebenen Typs wird nicht unterstützt.
E_FAIL	Fehler bei der Methode.

Bemerkungen

Diese Methode wird nur für Windows XP Pscript5-Plug-Ins unterstützt, nicht für Unidrv-Plug-Ins.

Die IPrintCoreUI2::QuerySimulationSupport-Methode speichert eine Spoolersimulationsfunktionsstruktur im Puffer, auf die durch pCapsverwiesen wird. Diese Struktur gibt die Ebene der Spoolerunterstützung für "N-up"-Druck, Umgekehrtdruck, die maximale Anzahl von Seiten an, die gedruckt, sortiert und andere.

Anforderungen

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

Siehe auch

IPrintCoreUI2-

SIMULATE_CAPS_1

Freigeben über