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

Article
02/29/2024

La IPrintOemDriverPS::DrvGetDriverSetting méthode est fournie par le pilote Pscript5 afin que les plug-ins de rendu puissent obtenir la status actuelle des fonctionnalités d’imprimante et d’autres informations internes.

Syntaxe

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

Paramètres

pdriverobj

Pointeur fourni par l’appelant vers une structure DEVOBJ .

Feature

Valeur fournie par l’appelant identifiant la fonctionnalité d’imprimante pour laquelle les paramètres d’option seront retournés. Il peut s’agir d’un pointeur de chaîne ou d’une constante, comme décrit dans la section Notes 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 de mémoire tampon minimale 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 retournée

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

Code de retour	Description
S_OK	L’opération a réussi.
E_FAIL	L’opération a échoué
E_NOTIMPL	Cette méthode n'est pas implémentée.

Remarques

Lorsque la IPrintOemDriverPS::DrvGetDriverSetting méthode est appelée, un pointeur de chaîne ou une valeur constante peut être spécifié pour pFeatureKeyword.

Si pFeatureKeyword est une chaîne, elle doit représenter un argument mot clé à une entrée *OpenUI dans le fichier PPD d’un minidriver Pscript5.
La méthode doit retourner une ou plusieurs chaînes terminées par NULL dans la mémoire tampon pointée par pOutput. Chaque chaîne doit représenter le nom d’une option actuellement sélectionnée. Le nombre de chaînes doit être retourné dans pdwOptionsReturned.
Si pFeatureKeyword est une constante, il doit s’agir de l’une des constantes OEMGDS_ préfixées définies dans printoem.h. La méthode doit retourner 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 doit être 1.

Configuration requise

Condition requise	Valeur
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	prcomoem.h (include Prcomoem.h)

Partager via