Fonction GetPrintProcessorCapabilities (winsplp.h)

Article
03/01/2024

La fonction GetPrintProcessorCapabilities d’un processeur d’impression retourne les fonctionnalités associées à un type de données d’entrée spécifié.

Syntaxe

DWORD GetPrintProcessorCapabilities(
  [in]  LPTSTR  pValueName,
  [in]  DWORD   dwAttributes,
  [out] LPBYTE  pData,
  [in]  DWORD   nSize,
  [out] LPDWORD pcbNeeded
);

Paramètres

[in] pValueName

Pointeur fourni par l’appelant vers une chaîne qui représente un type de données pris en charge par le processeur d’impression. Le pointeur de chaîne doit être de type LPWSTR.

[in] dwAttributes

Indicateurs d’attributs fournis par l’appelant. Reportez-vous au membre Attributes des structures PRINTER_INFO_x .

[out] pData

Pointeur fourni par l’appelant vers une structure PRINTPROCESSOR_CAPS_1 ou PRINTPROCESSOR_CAPS_2 .

[in] nSize

Valeur fournie par l’appelant qui représente la taille de la mémoire tampon pointée par pData.

Si la valeur est inférieure à sizeof(PRINTPROCESSOR_CAPS_1), cette fonction doit fournir une valeur égale à sizeof(PRINTPROCESSOR_CAPS_1) ou sizeof(PRINTPROCESSOR_CAPS_2), selon la structure prise en charge par le processeur d’impression.

Si la valeur est inférieure à sizeof(PRINTPROCESSOR_CAPS_1), le processeur d’impression winprint fournit la valeur sizeof(PRINTPROCESSOR_CAPS_2).

[out] pcbNeeded

Pointeur fourni par l’appelant vers un emplacement pour recevoir la taille minimale requise pour la mémoire tampon pointée par pData.

Valeur retournée

Si l’opération réussit, la fonction doit retourner ERROR_SUCCESS. Sinon, il doit retourner un code d’erreur Win32.

Remarques

Les processeurs d’impression peuvent éventuellement exporter une fonction GetPrintProcessorCapabilities . L’objectif de la fonction est de retourner une structure PRINTPROCESSOR_CAPS_1 ou PRINTPROCESSOR_CAPS_2 remplie pour chaque type de données d’entrée pris en charge par le processeur d’impression.

Le spouleur appelle la fonction GetPrintProcessorCapabilities d’un processeur d’impression lorsqu’une application appelle GetPrinterData, en spécifiant un nom de valeur au format PrintProcCaps_datatype, où datatype est le nom d’un type de données d’entrée. Avant d’appeler GetPrintProcessorCapabilities, le spouleur supprime le préfixe PrintProcCaps_ de la chaîne de nom de valeur.

La fonction doit déterminer si la mémoire tampon reçue est suffisamment grande et, le cas échéant, doit remplir le PRINTPROCESSOR_CAPS_1 ou PRINTPROCESSOR_CAPS_2 structure et retourner. La valeur de nSize détermine si PRINTPROCESSOR_CAPS_1 ou PRINTPROCESSOR_CAPS_2 seront utilisés.

La fonction doit toujours utiliser l’emplacement pointé par pcbNeeded pour renvoyer la taille de mémoire tampon requise, que la mémoire tampon réelle soit suffisamment grande ou non.

La valeur de retour spécifiée devient la valeur de retour fournie par le spouleur pour GetPrinterData.

Configuration requise

Condition requise	Valeur
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	winsplp.h (inclure Winsplp.h)

Share via