EVT_WDF_DEVICE_USAGE_NOTIFICATION_EX fonction de rappel (wdfdevice.h)

[S’applique à KMDF et UMDF]

La fonction de rappel d’événement EvtDeviceUsageNotificationEx d’un 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 d’un objet d’appareil framework.

[in] NotificationType

Valeur de type WDF_SPECIAL_FILE_TYPE qui identifie le type de fichier spécial que le système stocke sur l’appareil spécifié.

[in] IsInNotificationPath

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

Valeur retournée

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 status pour laquelle NT_SUCCESS(status) est égal à TRUE. Sinon, il doit retourner une valeur status pour laquelle NT_SUCCESS(status) est false.

Remarques

Si votre pilote doit fournir une gestion spécifique au pilote des fichiers spéciaux, vous devez fournir une fonction de rappel d’événement EvtDeviceUsageNotificationEx ou 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 échec status, l’infrastructure propage l’échec à d’autres piles qu’elle a peut-être signalées précédemment.

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

Configuration requise