IPrintCoreUI2 ::QuerySimulationSupport, méthode (prcomoem.h)

Article
02/07/2025

La méthode IPrintCoreUI2::QuerySimulationSupport récupère une structure de capacité de simulation de spouleur, qui indique les types de simulation pris en charge par le spouleur.

Syntaxe

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

Paramètres

[in] hPrinter

Spécifie un handle à l’imprimante.

[in] dwLevel

Spécifie la structure de capacité de simulation du spouleur retournée dans la mémoire tampon pointée par pCaps. Actuellement, seul le niveau 1 de la prise en charge de la simulation du spouleur est fourni.

Valeur	Structure de prise en charge de la simulation du spouleur
1	SIMULATE_CAPS_1 (défini dans printoem.h)

[out] pCaps

Pointeur vers la mémoire tampon de sortie, qui contient une structure du type indiqué par la valeur dans le paramètre dwLevel.

[in] cbSize

Spécifie la taille, en octets, de la mémoire tampon de sortie, pointée par pCaps.

[out] pcbNeeded

Spécifie la taille, en octets, de la mémoire nécessaire pour stocker une structure du type indiqué par dwLevel.

Valeur de retour

La méthode doit retourner l’une des valeurs suivantes.

Retourner le code	Description
S_OK	La méthode a réussi.
E_OUTOFMEMORY	La valeur de cbSize était inférieure au nombre d’octets à écrire dans la mémoire tampon de sortie (la mémoire tampon pointée par pCaps). La méthode a été appelée avec pCaps définie sur NULL.
E_NOTIMPL	La méthode n’est pas prise en charge. Une structure du type spécifié par dwLevel n’est pas prise en charge.
E_FAIL	Échec de la méthode

Remarques

Cette méthode est prise en charge uniquement pour les plug-ins Windows XP Pscript5, et non pour les plug-ins Unidrv.

La méthode IPrintCoreUI2::QuerySimulationSupport stocke une structure de capacité de simulation de spouleur dans la mémoire tampon pointée par pCaps. Cette structure spécifie le niveau de prise en charge du spouleur pour l’impression « N-up », l’impression inversée, le nombre maximal de pages qui peuvent être imprimées, le classement et d’autres.

Exigences

Exigence	Valeur
plateforme cible	Bureau
d’en-tête	prcomoem.h (include Prcomoem.h)

Voir aussi

IPrintCoreUI2

SIMULATE_CAPS_1

Partager via