PcForwardIrpSynchronous, fonction (portcls.h)
La fonction PcForwardIrpSynchronous est utilisée par les gestionnaires IRP pour transférer les irps Plug-and-Play aux objet d’appareil physique (PDO).
Syntaxe
PORTCLASSAPI NTSTATUS PcForwardIrpSynchronous(
[in] PDEVICE_OBJECT DeviceObject,
[in] PIRP Irp
);
Paramètres
[in] DeviceObject
Pointeur vers l’objet appareil de l’appareil audio. Ce paramètre doit pointer vers une structure système de type DEVICE_OBJECT.
[in] Irp
Pointeur vers l' IRP à transférer
Valeur de retour
PcForwardIrpSynchronous retourne STATUS_SUCCESS si l’appel a réussi. Sinon, elle retourne un code d’erreur approprié.
Remarques
PcForwardIrpSynchronous entraîne la réception de l’IRP et du blocage suivant jusqu’à ce que l’IRP soit terminé par le pilote de périphérique physique. À ce stade, PcForwardIrpSynchronous débloquer et retourne à l’appelant. L’appelant (gestionnaire IRP) doit éventuellement retourner,éventuellement avec un état de STATUS_PENDING. En général, tout gestionnaire IRP qui appelle cette fonction doit spécifier l’action IRP_ACTION_FINISH lors du retour. Toute autre action entraînerait le transfert de l’IRP vers l’appareil physique une deuxième fois.
La fonction PcCompleteIrp est utilisée lorsqu’un gestionnaire IRP retourne STATUS_PENDING et que l’IRP doit être terminé ultérieurement.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Le pilote système PortCls implémente la fonction PcForwardIrpSynchronous dans Microsoft Windows 98/Me et dans les systèmes d’exploitation Windows 2000 et versions ultérieures. |
| plateforme cible | Universel |
| d’en-tête | portcls.h (include Portcls.h) |
| bibliothèque | Portcls.lib |
| IRQL | PASSIVE_LEVEL |