PPARALLEL_READ fonction de rappel (parallel.h)

Article
02/07/2025

La routine de rappel typée PPARALLEL_READ lit les données d’un appareil parallèle. Le pilote de bus fourni par le système pour les ports parallèles fournit cette routine.

Syntaxe

PPARALLEL_READ PparallelRead;

NTSTATUS PparallelRead(
  [in]  PVOID Context,
  [out] PVOID Buffer,
  [in]  ULONG NumBytesToRead,
  [out] PULONG NumBytesRead,
  [in]  UCHAR Channel
)
{...}

Paramètres

[in] Context

Pointeur vers l’extension de l’appareil parallèle de l’objet d’appareil physique d’un appareil parallèle (PDO).

[out] Buffer

Pointeur vers une mémoire tampon de lecture que l’appelant alloue.

[in] NumBytesToRead

Spécifie le nombre d’octets à lire. Doit être inférieur ou égal au nombre d’octets dans la mémoire tampon de lecture allouée par l’appelant.

[out] NumBytesRead

Spécifie le nombre d’octets qui ont été réellement lus à partir de l’appareil parallèle et enregistrés dans la mémoire tampon de lecture allouée à l’appelant.

[in] Channel

Non utilisé.

Valeur de retour

Retourner le code	Description
STATUS_SUCCESS	Les données demandées ont été transférées à partir de l’appareil.
STATUS_xxx	Une opération interne a entraîné une erreur NTSTATUS.

Remarques

Pour obtenir un pointeur vers le rappel PPARALLEL_READ fourni par le système, un pilote en mode noyau utilise une requête IOCTL_INTERNAL_PARCLASS_CONNECT, qui retourne une structure PARCLASS_INFORMATION. Le membre ParallelRead de la structure PARCLASS_INFORMATION est un pointeur vers ce rappel.

Un client ne peut utiliser cette routine que s’il dispose d’un verrou sur un port parallèle. Un client obtient un verrou sur un port parallèle à l’aide d’une demande de IOCTL_INTERNAL_LOCK_PORT.

Le PPARALLEL_READ rappel s’exécute dans le thread de l’appelant au niveau du runtime d’intégration de l’appelant.

Exigences

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

Voir aussi

PPARALLEL_WRITE

IOCTL_INTERNAL_LOCK_PORT

Partager via