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
Condition requise | Valeur |
---|---|
Plateforme cible | Universal |
Version KMDF minimale | 1.11 |
Version UMDF minimale | 2.0 |
En-tête | wdfdevice.h (include Wdf.h) |
IRQL | PASSIVE_LEVEL |
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour