EVT_WDF_DEVICE_USAGE_NOTIFICATION_EX fonction de rappel (wdfdevice.h)

Article
02/07/2025

[S’applique à KMDF et UMDF]

La fonction de rappel d’événement evtDeviceUsageNotificationEx du pilote détermine si un appareil peut prendre en charge un type de fichier spécial.

Syntaxe

EVT_WDF_DEVICE_USAGE_NOTIFICATION_EX EvtWdfDeviceUsageNotificationEx;

NTSTATUS EvtWdfDeviceUsageNotificationEx(
  [in] WDFDEVICE Device,
  [in] WDF_SPECIAL_FILE_TYPE NotificationType,
  [in] BOOLEAN IsInNotificationPath
)
{...}

Paramètres

[in] Device

Handle vers un objet d’appareil framework.

[in] NotificationType

Valeur WDF_SPECIAL_FILE_TYPE-typée qui identifie le type de fichier spécial stocké par le système sur l’appareil spécifié.

[in] IsInNotificationPath

Valeur booléenne qui, si TRUE, indique que le système commence à utiliser le fichier spécial et, si faux, indique que le système a terminé d’utiliser le fichier spécial.

Valeur de retour

Si le pilote détermine que l’appareil peut prendre en charge le fichier spécial, la fonction de rappel EvtDeviceUsageNotificationEx doit retourner STATUS_SUCCESS ou une autre valeur d’état pour laquelle NT_SUCCESS(status) est égal à TRUE. Sinon, il doit retourner une valeur d’état pour laquelle NT_SUCCESS(status) est égal à FALSE.

Remarques

Si votre pilote doit fournir une gestion spécifique au pilote de fichiers spéciaux, vous devez fournir une EvtDeviceUsageNotificationEx ou une fonction de rappel d’événement EvtDeviceUsageNotification. Ne fournissez pas les deux fonctions de rappel.

Pour inscrire une fonction de rappel EvtDeviceUsageNotificationEx, un pilote doit appeler WdfDeviceInitSetPnpPowerEventCallbacks.

Si la fonction de rappel EvtDeviceUsageNotificationEx du pilote retourne un état d’échec, l’infrastructure propage l’échec à d’autres piles qu’il a peut-être averti précédemment.

Pour plus d’informations sur les fichiers spéciaux, consultez Prise en charge des fichiers spéciaux.

Exigences

Exigence	Valeur
plateforme cible	Universel
version minimale de KMDF	1.11
version minimale de UMDF	2.0
d’en-tête	wdfdevice.h (include Wdf.h)
IRQL	PASSIVE_LEVEL

Partager via