IPrintOemUni ::TTYGetInfo, méthode (prcomoem.h)

Article
02/07/2025

La méthode IPrintOemUni::TTYGetInfo permet à un plug-in de rendu de fournir unidrv avec des informations pertinentes pour les imprimantes texte uniquement.

Syntaxe

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

Paramètres

pdevobj

Pointeur fourni par l’appelant vers une structure DEVOBJ.

dwInfoIndex

Constante fournie par l’appelant identifiant le type d’informations demandées. Les valeurs constantes suivantes sont définies :

OEMTTY_INFO_CODEPAGE

Le paramètre pOutputBuf pointe vers un DWORD dans lequel la méthode doit retourner le nombre de pages de codes à utiliser.

OEMTTY_INFO_MARGINS

Le paramètre pOutputBuf pointe vers une structure RECT dans laquelle la méthode doit retourner des largeurs de marge de page, en dixièmes de millimètres (par exemple, 20 représente 2 mm). Si l’intégralité de la page est imprimable, toutes les valeurs de marge doivent être 0.

OEMTTY_INFO_NUM_UFMS

Le paramètre pOutputBuf pointe vers un DWORD dans lequel la méthode doit retourner le nombre d’ID de ressource des UFMs pour 10, 12 et 17 polices CPI. Pour obtenir réellement ces ID de ressource, effectuez une requête à l’aide de OEMTTY_INFO_UFM_IDS.

OEMTTY_INFO_UFM_IDS

Le paramètre pOutputBuf pointe vers un tableau de DWORD de taille suffisante pour contenir le nombre d’ID de ressources des UFMs pour 10, 12 et 17 polices CPI. (Ce nombre est obtenu à l’aide de OEMTTY_INFO_NUM_UFMS dans une requête.) La méthode doit retourner les ID de ressource des UFMs pour 10 12 et 17 polices CPI.

pOutputBuf

Pointeur fourni par l’appelant vers une mémoire tampon pour recevoir les informations demandées.

dwSize

Taille fournie par l’appelant, en octets, de la mémoire tampon pointée par pOutputBuf.

pcbcNeeded

Pointeur fourni par l’appelant vers un emplacement pour recevoir le nombre d’octets écrits dans la mémoire tampon pointée par pOutputBuf. Si le nombre d’octets requis est inférieur au nombre spécifié par dwSize, la méthode doit fournir la taille requise et retourner E_FAIL.

Valeur de retour

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

Retourner le code	Description
S_OK	L’opération a réussi.
E_FAIL	L’opération a échoué.
E_NOTIMPL	La méthode n’est pas implémentée.

Remarques

La méthode IPrintOemUni::TTYGetInfo est facultative. Si un plug-in de rendu implémente cette méthode, la méthode IPrintOemUni ::GetImplementedMethod doit retourner S_OK lorsqu’elle reçoit « TTYGetInfo » comme entrée.

Exigences

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

Partager via