Função IoStartNextPacket (ntifs.h)
A rotina IoStartNextPacket desativa o próximo IRP, se houver, da fila de dispositivos associada do objeto de dispositivo e chama a rotina StartIo do driver.
Sintaxe
void IoStartNextPacket(
[in] PDEVICE_OBJECT DeviceObject,
[in] BOOLEAN Cancelable
);
Parâmetros
[in] DeviceObject
Ponteiro para o objeto do dispositivo para o qual o IRP deve ser desemqueado.
[in] Cancelable
Especifica se os IRPs na fila do dispositivo podem ser cancelados.
Retornar valor
Nenhum
Comentários
Se não houver NENHUM IRPs atualmente na fila do dispositivo para o DeviceObject de destino, essa rotina simplesmente retornará o controle ao chamador.
Se o driver passou um ponteiro para uma rotina de cancelamento quando ele chamou IoStartPacket, ele deverá passar TRUE no parâmetro Cancelável dessa rotina. Se Cancelable for TRUE, o gerenciador de E/S usará o bloqueio de rotação de cancelamento para proteger a fila do dispositivo e o IRP atual.
Os drivers que não têm uma rotina StartIo não podem chamar IoStartNextPacket.
Os drivers que chamam IoStartNextPacket da rotina do StartIo devem estar cientes dos problemas de recursão. Se um driver puder chamar IoStartNextPacket em um grande número de solicitações sucessivas de sua rotina StartIo (por exemplo, quando ocorrer um erro de dispositivo e o driver estiver desmarcando a fila do dispositivo), você deverá definir o atributo DeferredStartIo para o dispositivo usando a rotina IoSetStartIoAttributes . Esse atributo garante que o próximo pacote não será emitido até que a chamada inicial anterior retorne.
Os chamadores de IoStartNextPacket devem estar em execução em IRQL = DISPATCH_LEVEL. Normalmente, essa rotina é chamada da rotina DpcForIsr ou CustomDpc de um driver de dispositivo, ambas executadas em IRQL = DISPATCH_LEVEL.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 |
| Plataforma de Destino | Universal |
| Cabeçalho | ntifs.h (inclui Wdm.h, Ntddk.h, Ntifs.h) |
| Biblioteca | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | DISPATCH_LEVEL (consulte a seção Comentários) |
| Regras de conformidade de DDI | HwStorPortProhibitedDIs(storport), IrqlDispatch(storport), IrqlDispatch(storport), IrqlDispatch(wdm), SpinLockSafe(storport), SpinLockSafe(storport), SpinLockSafe(wdm), StartIoRecursion(wdm) |