IPrintCoreUI2 ::D rvGetDriverSetting, méthode (prcomoem.h)

Article
02/07/2025

La méthode IPrintCoreUI2::DrvGetDriverSetting est fournie par le pilote Pscript5 Windows XP afin que les plug-ins d’interface utilisateur Pscript5 puissent obtenir l’état actuel des fonctionnalités d’imprimante et d’autres informations internes.

Syntaxe

HRESULT DrvGetDriverSetting(
  PVOID  pci,
  PCSTR  Feature,
  PVOID  pOutput,
  DWORD  cbSize,
  PDWORD pcbNeeded,
  PDWORD pdwOptionsReturned
);

Paramètres

pci

Pointeur fourni par l’appelant vers une structure OEMUIOBJ.

Feature

Valeur fournie par l’appelant identifiant la fonctionnalité d’imprimante pour laquelle les paramètres d’option sont retournés. Il peut s’agir d’un pointeur de chaîne ou d’une constante, comme décrit dans la section Remarques suivante.

pOutput

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

cbSize

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

pcbNeeded

Pointeur fourni par l’appelant vers un emplacement pour recevoir la taille minimale de la mémoire tampon requise pour contenir les informations demandées.

pdwOptionsReturned

Pointeur fourni par l’appelant vers un emplacement pour recevoir le nombre de chaînes d’option placées dans pOutput .

Valeur de retour

Cette 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

Cette méthode est héritée de l’interface COM IPrintOemDriverUI, et peut être appelée uniquement par les plug-ins d’interface utilisateur Windows XP et ultérieur Pscript5 qui ne remplacent pas entièrement les pages d’interface utilisateur standard du pilote principal, et est pris en charge pendant la IPrintOemUI ::D ocumentPropertySheets et IPrintOemUI ::D evicePropertySheets fonctions et leurs routines de rappel de feuille de propriétés. Lorsque cette méthode est prise en charge, elle a le même comportement que IPrintOemDriverUI ::D rvGetDriverSetting. Lorsqu’elle n’est pas prise en charge, cette méthode doit retourner E_NOTIMPL.