DrvSplDeviceCaps, fonction (winddiui.h)

Article
02/07/2025

Une DLL d’interface d’imprimante DrvSplDeviceCaps fonction interroge une imprimante pour ses fonctionnalités.

Syntaxe

DWORD DrvSplDeviceCaps(
                  HANDLE   hPrinter,
  [in]            PWSTR    pszDeviceName,
                  WORD     Capability,
  [out, optional] PVOID    pOutput,
                  DWORD    cchBufSize,
  [in, optional]  PDEVMODE pDevmode
);

Paramètres

hPrinter

Handle fourni par l’appelant à l’imprimante.

[in] pszDeviceName

Pointeur fourni par l’appelant vers une chaîne Unicode qui contient le nom de l’imprimante.

Capability

Indicateur de bits fourni par l’appelant qui indique la possibilité d’effectuer une requête. (Les indicateurs sont définis dans le fichier d’en-tête wingdi.h.) Cette fonction n’est pas nécessaire pour prendre en charge tous les indicateurs de DC_XXX, mais elle doit prendre en charge celles répertoriées dans le tableau suivant.

Drapeau	Définition
DC_MEDIAREADY	Le paramètre pOutput pointe vers une mémoire tampon que la fonction doit remplir avec un tableau de mémoires tampons de chaîne, chacune 64 caractères de longueur. Chaque élément de tableau doit contenir une chaîne terminée par NULL représentant un nom pour un formulaire papier disponible pour une utilisation. La valeur de retour de la fonction doit être le nombre d’éléments dans le tableau retourné. Si pOutput est NULL, la fonction doit simplement retourner le nombre d’éléments de tableau requis.
DC_PAPERNAMES	Le paramètre pOutput pointe vers une mémoire tampon que la fonction doit remplir avec un tableau de mémoires tampons de chaîne, chacune 64 caractères de longueur. Chaque élément de tableau doit contenir une chaîne terminée par NULL représentant un nom pour un formulaire papier. La valeur de retour de la fonction doit être le nombre d’éléments dans le tableau retourné. Si pOutput est NULL, la fonction doit simplement retourner le nombre d’éléments de tableau requis.

Drapeau

Définition

DC_MEDIAREADY

Le paramètre pOutput pointe vers une mémoire tampon que la fonction doit remplir avec un tableau de mémoires tampons de chaîne, chacune 64 caractères de longueur. Chaque élément de tableau doit contenir une chaîne terminée par NULL représentant un nom pour un formulaire papier disponible pour une utilisation. La valeur de retour de la fonction doit être le nombre d’éléments dans le tableau retourné. Si pOutput est NULL, la fonction doit simplement retourner le nombre d’éléments de tableau requis.

DC_PAPERNAMES

Le paramètre pOutput pointe vers une mémoire tampon que la fonction doit remplir avec un tableau de mémoires tampons de chaîne, chacune 64 caractères de longueur. Chaque élément de tableau doit contenir une chaîne terminée par NULL représentant un nom pour un formulaire papier. La valeur de retour de la fonction doit être le nombre d’éléments dans le tableau retourné. Si pOutput est NULL, la fonction doit simplement retourner le nombre d’éléments de tableau requis.

[out, optional] pOutput

Pointeur fourni par l’appelant vers une mémoire tampon qui reçoit des informations fournies par la fonction. L’utilisation de la mémoire tampon dépend de la valeur du paramètre Fonctionnalité. L’appelant est responsable de l’allocation et de la libération de cette mémoire tampon.

cchBufSize

Taille fournie par l’appelant (en caractères) de la mémoire tampon pointée par le paramètre pOutput.

[in, optional] pDevmode

Pointeur fourni par l’appelant vers une structure DEVMODEW qui décrit les caractéristiques actuelles du travail d’impression. Si NULL, la fonction doit utiliser la structure DEVMODEW interne du pilote.

Valeur de retour

La valeur de retour dépend du paramètre de capacité. Si fonctionnalité indique une fonctionnalité que le pilote ne prend pas en charge ou si une erreur est rencontrée, la fonction doit retourner GDI_ERROR.

Remarques

Pour obtenir des descriptions des indicateurs DC_XXX, consultez DrvDeviceCapabilities .

Cette fonction doit être définie dans le fichier .def en tant que DrvSplDeviceCaps @ 254, car le spouleur utilise le numéro ordinal 254 pour obtenir le pointeur de fonction du pilote.

Exigences

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

Voir aussi

DrvDeviceCapabilities

Partager via