Condividi tramite


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