PPARALLEL_DESELECT_ROUTINE fonction de rappel (parallel.h)

Article
02/29/2024

La routine de rappel de type PPARALLEL_DESELECT_ROUTINE désélectionne un appareil de chaîne daisy IEEE 1284.3 ou un appareil de fin de chaîne IEEE 1284 attaché à un port parallèle. Le pilote de fonction fourni par le système pour les ports parallèles fournit cette routine.

Syntaxe

PPARALLEL_DESELECT_ROUTINE PparallelDeselectRoutine;

NTSTATUS PparallelDeselectRoutine(
  [in] PVOID DeselectContext,
  [in] PVOID DeselectCommand
)
{...}

Paramètres

[in] DeselectContext

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

[in] DeselectCommand

Pointeur vers une structure PARALLEL_1284_COMMAND. L’appelant spécifie les membres suivants :

id

Spécifie l’ID d’appareil 1284.3 (zéro ou 1).

CommandFlags

Spécifie un OR au niveau du bit de zéro ou plus des indicateurs suivants :

Valeur	Description
PAR_END_OF_CHAIN_DEVICE	Spécifie un appareil de fin de chaîne.
PAR_HAVE_PORT_KEEP_PORT	Spécifie que le port doit rester alloué.

Valeur retournée

Code de retour	Description
STATUS_SUCCESS	L’appareil a été désélectionné.
STATUS_INVALID_PARAMETER	L’ID d’appareil spécifié n’est pas valide.
STATUS_UNSUCCESSFUL	Le pilote de fonction fourni par le système pour les ports parallèles n’a pas pu désélectionner l’appareil.

Remarques

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

Un pilote en mode noyau peut utiliser une demande IOCTL_INTERNAL_DESELECT_DEVICE ou le rappel PPARALLEL_CLEAR_CHIP_MODE pour désélectionner un appareil sur un port parallèle représenté par un port parallèle. Pour désélectionner un appareil, un appelant doit avoir le port parallèle alloué. Si l’appelant ne définit pas l’indicateur PAR_HAVE_PORT_KEEP_PORT, le pilote de fonction fourni par le système pour les ports parallèles libère le port parallèle après avoir désélectionnement de l’appareil.

Pour plus d’informations, consultez Sélection et désélection d’un appareil IEEE 1284 attaché à un ParallelPort.