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

Article
02/07/2025

La méthode IPrintOemDriverUI::DrvGetDriverSetting est fournie par les minidrivers Unidrv et Pscript5 afin que les plug-ins d’interface utilisateur puissent obtenir l’état actuel des fonctionnalités de l’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

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

Lors de l’appel de la méthode IPrintOemDriverUI::DrvGetDriverSetting, un plug-in d’interface utilisateur peut spécifier un pointeur de chaîne ou une valeur constante pour pFeatureKeyword.

Si pFeatureKeyword est une chaîne, elle doit représenter l’une des valeurs suivantes :
- Nom de fonctionnalité spécifié dans un minidriver Unidrv fichier GPD ou,
- Argument de mot clé d’une entrée *OpenUI dans le fichier PPD d’un minidriver Pscript5.
La méthode retourne une ou plusieurs chaînes terminées par NULL dans la mémoire tampon pointée par pOutput . Chaque chaîne représente le nom d’une option actuellement sélectionnée. Le nombre de chaînes est retourné dans pdwOptionsReturned.
Si pFeatureKeyword est une constante, il doit s’agir de l’une des constantes OEMGDS_-préfixe définies dans printoem.h. La méthode retourne la valeur indiquée par la constante spécifiée en la plaçant dans la mémoire tampon pointée par pOutput. La valeur retournée dans pdwOptionsReturned est toujours 1.

Exigences

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

Partager via