Fonction PcForwardIrpSynchronous (portcls.h)
La fonction PcForwardIrpSynchronous est utilisée par les gestionnaires IRP pour transférer Plug-and-Play irps à l’objet d’appareil physique (PDO).
Syntaxe
PORTCLASSAPI NTSTATUS PcForwardIrpSynchronous(
[in] PDEVICE_OBJECT DeviceObject,
[in] PIRP Irp
);
Paramètres
[in] DeviceObject
Pointeur vers l’objet d’appareil du périphérique audio. Ce paramètre doit pointer vers une structure système de type DEVICE_OBJECT.
[in] Irp
Pointeur vers l’IRP à transférer
Valeur retournée
PcForwardIrpSynchronous retourne STATUS_SUCCESS si l’appel a réussi. Sinon, il retourne un code d’erreur approprié.
Remarques
PcForwardIrpSynchronous entraîne la réception de l’IRP et le blocage du PDO suivant jusqu’à ce que l’IRP soit terminé par le pilote de périphérique physique. À ce stade, PcForwardIrpSynchronous débloque et retourne à l’appelant. L’appelant (un gestionnaire IRP) doit éventuellement revenir, éventuellement avec un status 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 à 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 effectué ultérieurement.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal 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 ultérieurs. |
| Plateforme cible | Universal |
| En-tête | portcls.h (include Portcls.h) |
| Bibliothèque | Portcls.lib |
| IRQL | PASSIVE_LEVEL |