Funzione KeRemoveByKeyDeviceQueue (wdm.h)

Articolo
07.02.2025

La routine KeRemoveByKeyDeviceQue ue rimuove una voce, selezionata in base a un valore di chiave di ordinamento, dalla coda del dispositivo specificata.

Sintassi

C++

PKDEVICE_QUEUE_ENTRY KeRemoveByKeyDeviceQueue(
  [in, out] PKDEVICE_QUEUE DeviceQueue,
  [in]      ULONG          SortKey
);

Parametri

[in, out] DeviceQueue

Puntatore a un oggetto coda di dispositivi inizializzato per il quale il chiamante fornisce l'archiviazione.

[in] SortKey

Specifica la chiave da usare durante la ricerca nel DeviceQueue.

Valore restituito

KeRemoveByKeyDeviceQueue restituisce la voce della coda del dispositivo rimossa; restituisce NULL se la coda è vuota.

Osservazioni

Questa routine cerca la prima voce nella coda del dispositivo con un valore maggiore o uguale all'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.

È un errore chiamare KeRemoveByKeyDeviceQueue quando l'oggetto coda del dispositivo è impostato su uno stato non occupato.

Fabbisogno

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)