Funzione KeRemoveByKeyDeviceQueue (wdm.h)
La routine KeRemoveByKeyDeviceQueue rimuove una voce, selezionata in base a un valore di chiave di ordinamento, dalla coda del dispositivo specificata.
Sintassi
PKDEVICE_QUEUE_ENTRY KeRemoveByKeyDeviceQueue(
[in, out] PKDEVICE_QUEUE DeviceQueue,
[in] ULONG SortKey
);
Parametri
[in, out] DeviceQueue
Puntatore a un oggetto coda del dispositivo inizializzato per il quale il chiamante fornisce la risorsa di archiviazione.
[in] SortKey
Specifica la chiave da usare durante la ricerca in DeviceQueue.
Valore restituito
KeRemoveByKeyDeviceQueue restituisce la voce della coda del dispositivo rimossa; restituisce NULL se la coda è vuota.
Commenti
Questa routine cerca la prima voce nella coda del dispositivo con un valore maggiore o uguale a SortKey. Dopo aver trovato questa voce, questa routine rimuove la voce dalla coda del dispositivo e la restituisce. Se non viene trovata alcuna voce di questo tipo, viene restituita la prima voce nella coda. Se la coda del dispositivo è vuota, il dispositivo viene impostato su uno stato non occupato e viene restituito un puntatore NULL .
Si tratta di un errore per chiamare KeRemoveByKeyDeviceQueue 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) |