Funzione IoStartNextPacketByKey (ntifs.h)

La routine IoStartNextPacketByKey rimuove il pacchetto di richiesta I/O successivo dalla coda del dispositivo associata all'oggetto dispositivo specificato in base a un valore di chiave di ordinamento specificato e chiama la routine StartIo del driver con tale IRP.

Sintassi

void IoStartNextPacketByKey(
  [in] PDEVICE_OBJECT DeviceObject,
  [in] BOOLEAN        Cancelable,
  [in] ULONG          Key
);

Parametri

[in] DeviceObject

Puntatore all'oggetto dispositivo per il quale l'IRP deve essere dequeuato.

[in] Cancelable

Specifica se i runtime di integrazione nella coda del dispositivo possono essere annullati.

[in] Key

Specifica la chiave di ordinamento che determina la voce da rimuovere dalla coda.

Valore restituito

nessuno

Osservazioni

Se nella coda del dispositivo non sono presenti provider di integrazione per l'oggetto dispositivo di destinazione, questa routine restituisce semplicemente il controllo al chiamante.

Se il driver ha passato un puntatore a una routine di annullamento quando ha chiamato IoStartPacket, deve passare TRUE nel parametro Cancelable di questa routine. Se Cancelable è TRUE, il gestore di I/O userà il blocco di selezione annulla per proteggere la coda del dispositivo e l'IRP corrente.

I driver che non dispongono di una routine StartIo non possono chiamare IoStartNextPacketByKey.

I chiamanti di IoStartNextPacketByKey devono essere in esecuzione in IRQL <= DISPATCH_LEVEL. In genere, questa routine viene chiamata dalla routine DpcForIsr o CustomDpc di un driver di dispositivo, entrambe eseguite in IRQL = DISPATCH_LEVEL.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000
Piattaforma di destinazione	Universale
Intestazione	ntifs.h (include Wdm.h, Ntddk.h, Ntifs.h)
Libreria	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL

Vedi anche

DEVICE_OBJECT

IoStartNextPacket

IoStartPacket