IPrintOemDriverUni ::D rvGetGPDData, méthode (prcomoem.h)

Article
02/07/2025

La méthode IPrintOemDriverUni::DrvGetGPDData est fournie par le pilote Unidrv afin que les plug-ins de rendu puissent obtenir des données définies dans le fichier GPD d’une imprimante.

Syntaxe

HRESULT DrvGetGPDData(
  PDEVOBJ pdevobj,
  DWORD   dwType,
  PVOID   pInputData,
  PVOID   pBuffer,
  DWORD   cbSize,
  PDWORD  pcbNeeded
);

Paramètres

pdevobj

Pointeur fourni par l’appelant vers une structure DEVOBJ.

dwType

Indicateur fourni par l’appelant indiquant le type de données GPD demandées. Actuellement, l’indicateur suivant est le seul défini :

Drapeau	Définition
GPD_OEMCUSTOMDATA	La méthode retourne la chaîne associée à un fichier GPD *OEMCustomData entrée.

pInputData

Réservé. Doit être égal à zéro.

pBuffer

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

cbSize

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

pcbNeeded

Reçoit la taille minimale de mémoire tampon fournie par le pilote, en octets, requise pour contenir les informations demandées.

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

Si la mémoire tampon spécifiée par pBuffer et cbSize est trop petite pour recevoir les informations demandées, Unidrv fournit la taille de mémoire tampon requise à l’emplacement vers lequel pointe de secours, retourne E_FAIL et définit le code d’erreur sur ERROR_INSUFFICIENT_BUFFER.

Exigences

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

Partager via