Fonction IoStartPacket (wdm.h)
La routine IoStartPacket appelle la routine StartIo du pilote avec l’IRP donné ou insère l’IRP dans la file d’attente d’appareil associée à l’objet d’appareil donné si l’appareil est déjà occupé.
Syntaxe
void IoStartPacket(
[in] PDEVICE_OBJECT DeviceObject,
[in] PIRP Irp,
[in, optional] PULONG Key,
[in, optional] PDRIVER_CANCEL CancelFunction
);
Paramètres
[in] DeviceObject
Pointeur vers l’objet d’appareil cible pour l’IRP.
[in] Irp
Pointeur vers l’IRP à traiter.
[in, optional] Key
Pointeur vers une valeur qui détermine où insérer le paquet dans la file d’attente de l’appareil. Si cette valeur est égale à zéro, le paquet est inséré à la fin de la file d’attente de l’appareil.
[in, optional] CancelFunction
Spécifie le point d’entrée d’une routine Cancel fournie par le pilote.
Valeur de retour
None
Remarques
Si le pilote est déjà occupé à traiter une demande pour l’objet d’appareil cible, le paquet est mis en file d’attente dans la file d’attente de l’appareil. Sinon, cette routine appelle la routine StartIo du pilote avec l’IRP spécifié.
Si un pointeur CancelFunction non NULL est fourni, il est défini dans l’IRP de sorte que la routine Cancel du pilote est appelée si l’IRP est annulé avant son achèvement.
Les pilotes qui n’ont pas de routine StartIo ne peuvent pas appeler IoStartPacket.
Les appelants d’IoStartPacket doivent être en cours d’exécution dans IRQL <= DISPATCH_LEVEL. En règle générale, cette routine est appelée à partir de la routine Dispatch d’un pilote de périphérique à IRQL = PASSIVE_LEVEL.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible à partir de Windows 2000. |
| Plateforme cible | Universal |
| En-tête | wdm.h (inclure Wdm.h, Ntddk.h, Ntifs.h) |
| Bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL (voir la section Remarques) |