Funzione KeRemoveByKeyDeviceQueue (wdm.h)

Articolo
03/05/2024

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)