Função IoStartNextPacketByKey (wdm.h)
A rotina IoStartNextPacketByKey desativa o próximo pacote de solicitação de E/S da fila de dispositivos associada do objeto de dispositivo especificado de acordo com um valor de chave de classificação especificado e chama a rotina de StartIo do driver com esse IRP.
Sintaxe
void IoStartNextPacketByKey(
[in] PDEVICE_OBJECT DeviceObject,
[in] BOOLEAN Cancelable,
[in] ULONG Key
);
Parâmetros
[in] DeviceObject
Ponteiro para o objeto do dispositivo para o qual o IRP deve ser desativado.
[in] Cancelable
Especifica se os IRPs na fila do dispositivo podem ser cancelados.
[in] Key
Especifica a chave de classificação que determina qual entrada remover da fila.
Valor de retorno
Nenhum
Observações
Se não houver NENHUM IRPs atualmente na fila do dispositivo para o objeto de dispositivo de destino, essa rotina simplesmente retornará o controle ao chamador.
Se o driver passou um ponteiro para uma rotina de cancelamento quando chamou IoStartPacket, ele deverá passar TRUE no parâmetro Cancelável. Se cancelável for VERDADEIRO, 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 de startio não podem chamar IoStartNextPacketByKey .
Os chamadores de IoStartNextPacketByKey devem estar em execução no IRQL <= DISPATCH_LEVEL. Normalmente, essa rotina é chamada da rotina de DpcForIsr de um driver de dispositivo ou rotina de CustomDpc, ambas executadas em IRQL = DISPATCH_LEVEL.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível a partir do Windows 2000. |
| da Plataforma de Destino | Universal |
| cabeçalho | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| biblioteca | NtosKrnl.lib |
| de DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |