PPARALLEL_DESELECT_ROUTINE fonction de rappel (parallel.h)

La routine de rappel PPARALLEL_DESELECT_ROUTINE typée désélectionne un appareil de chaîne IEEE 1284.3 ou un appareil de bout en bout 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 une 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 de chaîne.
PAR_HAVE_PORT_KEEP_PORT Spécifie que le port doit être 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.

Notes

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 de 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 requête 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é à un ParallelPort.

Spécifications

   
Plateforme cible Bureau
En-tête parallel.h (include Parallel.h)
IRQL <=DISPATCH_LEVEL

Voir aussi

IOCTL_INTERNAL_SELECT_DEVICE

PPARALLEL_TRY_SELECT_ROUTINE

IOCTL_INTERNAL_DESELECT_DEVICE

PARALLEL_PNP_INFORMATION