Fonction DrvSplDeviceCaps (winddiui.h)

Article
03/13/2023

La fonction DrvSplDeviceCaps d’une DLL d’interface d’imprimante 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 capacité à rechercher. (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 DC_XXX , mais elle doit prendre en charge ceux répertoriés dans le tableau suivant.

Indicateur	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, chacun de 64 caractères. Chaque élément de tableau doit contenir une chaîne terminée par NULL représentant un nom pour un formulaire papier disponible pour l’utilisation. La valeur de retour de la fonction doit être le nombre d’éléments dans le tableau retourné. Si pOutput a la valeur NULL, la fonction doit simplement renvoyer 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, chacun de 64 caractères. Chaque élément de tableau doit contenir une chaîne 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 a la valeur NULL, la fonction doit simplement renvoyer le nombre d’éléments de tableau requis.

Indicateur

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, chacun de 64 caractères. Chaque élément de tableau doit contenir une chaîne terminée par NULL représentant un nom pour un formulaire papier disponible pour l’utilisation. La valeur de retour de la fonction doit être le nombre d’éléments dans le tableau retourné. Si pOutput a la valeur NULL, la fonction doit simplement renvoyer 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, chacun de 64 caractères. Chaque élément de tableau doit contenir une chaîne 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 a la valeur NULL, la fonction doit simplement renvoyer 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 Capability . 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 vers 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 la valeur est NULL, la fonction doit utiliser la structure DEVMODEW par défaut interne du pilote.

Valeur retournée

La valeur de retour dépend du paramètre Capability . Si La 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 une description 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 nombre ordinal 254 pour obtenir le pointeur de la fonction pilote.

Configuration requise

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

Voir aussi

DrvDeviceCapabilities

Partager via