KeRemoveByKeyDeviceQueue, fonction (wdm.h)

La routine KeRemoveByKeyDeviceQue ue supprime une entrée, sélectionnée en fonction d’une valeur de clé de tri, dans la file d’attente de l’appareil spécifiée.

Syntaxe

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

Paramètres

[in, out] DeviceQueue

Pointeur vers un objet de file d’attente d’appareil initialisé pour lequel l’appelant fournit le stockage.

[in] SortKey

Spécifie la clé à utiliser lors de la recherche du DeviceQueue.

Valeur de retour

KeRemoveByKeyDeviceQueue retourne l’entrée de file d’attente de l’appareil qui a été supprimée ; retourne NULL si la file d’attente était vide.

Remarques

Cette routine recherche la première entrée dans la file d’attente de l’appareil dont la valeur est supérieure ou égale à la SortKey. Une fois cette entrée trouvée, cette routine supprime l’entrée de la file d’attente de l’appareil et la retourne. Si aucune entrée de ce type n’est trouvée, la première entrée de la file d’attente est retournée. Si la file d’attente de l’appareil est vide, l’appareil est défini sur un état non occupé et un pointeur NULL est retourné.

Il s’agit d’une erreur d’appel KeRemoveByKeyDeviceQueue lorsque l’objet de file d’attente de l’appareil est défini sur un état non occupé.

Exigences

Voir aussi

KeInitializeDeviceQueue

KeInsertByKeyDeviceQueue

keInsertDeviceQueue

KeRemoveDeviceQueue

KeRemoveEntryDeviceQueue