IPrintOemDriverPS ::D rvGetDriverSetting, méthode (prcomoem.h)
La méthode IPrintOemDriverPS::DrvGetDriverSetting
est fournie par le pilote Pscript5 afin que les plug-ins de rendu puissent obtenir l’état actuel des fonctionnalités de l’imprimante et d’autres informations internes.
HRESULT DrvGetDriverSetting(
PVOID pdriverobj,
PCSTR Feature,
PVOID pOutput,
DWORD cbSize,
PDWORD pcbNeeded,
PDWORD pdwOptionsReturned
);
pdriverobj
Pointeur fourni par l’appelant vers une structure DEVOBJ.
Feature
L’appelant a fourni une valeur 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 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 .
La méthode doit retourner l’une des valeurs suivantes.
Retourner le code | Description |
---|---|
|
L’opération a réussi. |
|
Échec de l’opération |
|
La méthode n’est pas implémentée. |
Lorsque la méthode IPrintOemDriverPS::DrvGetDriverSetting
est appelée, un pointeur de chaîne ou une valeur constante peut être spécifié pour pFeatureKeyword.
-
Si pFeatureKeyword est une chaîne, il doit représenter un argument de 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éfixe 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.
Exigence | Valeur |
---|---|
plateforme cible | Bureau |
d’en-tête | prcomoem.h (include Prcomoem.h) |