PPARALLEL_DESELECT_ROUTINE fonction de rappel (parallel.h)

Article
02/07/2025

La routine de rappel typée PPARALLEL_DESELECT_ROUTINEdésélectionne un appareil de chaîne de chaîne 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 plusieurs des indicateurs suivants :

Valeur	Description
PAR_END_OF_CHAIN_DEVICE	Spécifie un appareil de bout en bout.
PAR_HAVE_PORT_KEEP_PORT	Spécifie que le port doit être alloué.

Valeur de retour

Retourner le code	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 de 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 disposer du 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électionnement d’un appareil IEEE 1284 attaché à unParallelPort .