Funzione KeRemoveDeviceQueue (wdm.h)

La routine KeRemoveDeviceQueue rimuove una voce dall'intestazione di una coda di dispositivi specificata.

Sintassi

PKDEVICE_QUEUE_ENTRY KeRemoveDeviceQueue(
  [in, out] PKDEVICE_QUEUE DeviceQueue
);

Parametri

[in, out] DeviceQueue

Puntatore a un oggetto coda del dispositivo inizializzato per il quale il chiamante fornisce la risorsa di archiviazione.

Valore restituito

Se la coda del dispositivo è vuota ma è impostata su uno stato occupato, KeRemoveDeviceQueue restituisce NULL.

Commenti

Il blocco spin della coda del dispositivo specificato viene acquisito e lo stato della coda del dispositivo viene controllato. Se la coda del dispositivo è impostata su uno stato occupato e viene accodato un IRP, questa routine rimuove dalla coda la voce e restituisce un puntatore all'IRP. Una chiamata a KeRemoveDeviceQueue quando l'oggetto coda del dispositivo è impostato su uno stato occupato, ma nessun IRP viene accodato causa una modifica dello stato non occupato. Il blocco spin della coda del dispositivo specificato viene rilasciato.

Si tratta di un errore per chiamare KeRemoveDeviceQueue quando l'oggetto coda del dispositivo è impostato su uno stato non occupato.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile a partire da Windows 2000.
Piattaforma di destinazione	Universale
Intestazione	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Libreria	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	DISPATCH_LEVEL
Regole di conformità DDI	HwStorPortProhibitedDDDIs(storport), IrqlDispatch(storport), IrqlDispatch(storport), IrqlDispatch(wdm)

Vedi anche

KeInitializeDeviceQueue

KeInsertByKeyDeviceQueue

KeInsertDeviceQueue

KeRemoveByKeyDeviceQueue

KeRemoveEntryDeviceQueue