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) |