EVT_WDF_DEVICE_FILE_CREATE fonction de rappel (wdfdevice.h)

  • Article

[S’applique à KMDF et UMDF]

La fonction de rappel EvtDeviceFileCreate d’un pilote gère les opérations qui doivent être effectuées lorsqu’une application demande l’accès à un appareil.

Syntaxe

EVT_WDF_DEVICE_FILE_CREATE EvtWdfDeviceFileCreate;

void EvtWdfDeviceFileCreate(
  [in] WDFDEVICE Device,
  [in] WDFREQUEST Request,
  [in] WDFFILEOBJECT FileObject
)
{...}

Paramètres

[in] Device

Handle d’un objet d’appareil framework.

[in] Request

Handle d’un objet de demande d’infrastructure qui représente une demande de création de fichier.

[in] FileObject

Handle d’un objet de fichier framework qui décrit un fichier en cours d’ouverture pour la requête spécifiée. Ce paramètre a la valeur NULL si le pilote a spécifié WdfFileObjectNotRequired pour le membre FileObjectClass de la structure WDF_FILEOBJECT_CONFIG .

Valeur de retour

None

Remarques

L’infrastructure appelle la fonction de rappel EvtDeviceFileCreate d’un pilote lorsqu’une application utilisateur ou un autre pilote ouvre l’appareil pour effectuer une opération d’E/S, telle que la lecture ou l’écriture d’un fichier.

Le pilote peut passer le handle de requête à WdfRequestGetParameters pour récupérer les paramètres associés à la demande de création de fichier. Les paramètres sont stockés dans le membre Parameters.Create de la structure WDF_REQUEST_PARAMETERS .

Cette fonction de rappel est appelée de manière synchrone, dans le contexte du thread qui ouvre l’appareil.

Pour inscrire une fonction de rappel EvtDeviceFileCreate , le pilote doit appeler la méthode WdfDeviceInitSetFileObjectConfig .

Le pilote doit terminer la demande ou l’envoyer avec WDF_REQUEST_SEND_OPTION_SEND_AND_FORGET.

Le pilote peut également recevoir des demandes de création dans une file d’attente. Pour plus d’informations, consultez WdfDeviceConfigureRequestDispatching.

Pour plus d’informations sur les objets de fichier framework et la fonction de rappel EvtDeviceFileCreate , consultez Framework File Objects.

Configuration requise

Condition requise Valeur
Plateforme cible Universal
Version KMDF minimale 1.0
Version UMDF minimale 2.0
En-tête wdfdevice.h (include Wdf.h)
IRQL PASSIVE_LEVEL

Voir aussi

WDF_FILEOBJECT_CONFIG