EVT_WDF_DEVICE_FILE_CREATE fonction de rappel (wdfdevice.h)

[S’applique à KMDF et UMDF]

La fonction de rappel EvtDeviceFileCreate 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 vers un objet d’appareil framework.

[in] Request

Handle vers un objet de requête framework qui représente une demande de création de fichier.

[in] FileObject

Handle vers un objet de fichier framework qui décrit un fichier ouvert pour la requête spécifiée. Ce paramètre est NULL si le pilote a spécifié WdfFileObjectNotRequired pour le membre fileObjectClass de la structure WDF_FILEOBJECT_CONFIG.

Valeur de retour

Aucun

Remarques

L’infrastructure appelle le EvtDeviceFileCreate fonction de rappel 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 transmettre le handle 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 façon 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 effectuer la requête 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.

Exigences

Voir aussi

WDF_FILEOBJECT_CONFIG