PPARALLEL_QUERY_WAITERS_ROUTINE fonction de rappel (parallel.h)

Article
02/26/2024

La routine de rappel de type PPARALLEL_QUERY_WAITERS_ROUTINE retourne le nombre de demandes IOCTL_INTERNAL_PARALLEL_PORT_ALLOCATE et IOCTL_INTERNAL_SELECT_DEVICE qui sont mises en file d’attente sur la file d’attente de travail d’un port parallèle. Le pilote de fonction fourni par le système pour les ports parallèles fournit cette routine.

Syntaxe

PPARALLEL_QUERY_WAITERS_ROUTINE PparallelQueryWaitersRoutine;

ULONG PparallelQueryWaitersRoutine(
  [in] PVOID QueryAllocsContext
)
{...}

Paramètres

[in] QueryAllocsContext

Pointeur vers l’extension d’appareil d’un objet d’appareil fonctionnel (FDO) qui représente un port parallèle.

Valeur retournée

Nombre de demandes mises en file d’attente sur la file d’attente de travail du port parallèle.

Remarques

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

Un pilote peut utiliser le rappel PPARALLEL_QUERY_WAITERS_ROUTINE pour ajuster son utilisation du port parallèle en fonction du nombre d’autres clients qui attendent l’accès au port parallèle. Le pilote de fonction fourni par le système pour les ports parallèles met uniquement en file d’attente les demandes d’allocation et de sélection.

Pour plus d’informations, consultez Synchronisation de l’utilisation d’un ParallelPort.