Partager via

WdfFileObjectGetFileName, fonction (wdffileobject.h)

  • Article

[S’applique à KMDF et UMDF]

La méthode WdfFileObjectGetFileName retourne le nom de fichier qu’un objet de fichier d’infrastructure spécifié contient.

Syntaxe

PUNICODE_STRING WdfFileObjectGetFileName(
  [in] WDFFILEOBJECT FileObject
);

Paramètres

[in] FileObject

Handle pour un objet de fichier d’infrastructure.

Valeur retournée

WdfFileObjectGetFileName renvoie un pointeur vers une structure UNICODE_STRING qui contient le nom de fichier. La méthode retourne NULL s’il n’existe aucun objet de fichier WDM pour l’objet de fichier d’infrastructure spécifié, ou s’il est appelé à une valeur IRQL supérieure à PASSIVE_LEVEL.

Un bogue case activée se produit si le pilote fournit un handle d’objet non valide.

Remarques

Si un pilote a spécifié une chaîne de référence lorsqu’il a appelé WdfDeviceCreateDeviceInterface, WdfFileObjectGetFileName retourne la chaîne de référence précédée d’une barre oblique inverse. Pour déterminer la chaîne de référence, supprimez la barre oblique inverse.

La chaîne retournée peut contenir un nom de fichier ou une chaîne de référence. La chaîne ne contient pas le nom de l’appareil. Si une application ou un composant en mode noyau a ouvert l’appareil au lieu d’un fichier, sans chaîne de référence, le membre Length de la structure UNICODE_STRING retournée est égal à zéro.

Votre pilote doit uniquement appeler WdfFileObjectGetFileName pendant le traitement d’une demande de création de fichier (type de requête WdfRequestTypeCreate ). Votre pilote peut traiter les demandes d’E/S de type WdfRequestTypeCreate dans une fonction de rappel EvtDeviceFileCreate .

Ou, au lieu de fournir une fonction de rappel EvtDeviceFileCreate , le pilote peut appeler WdfDeviceConfigureRequestDispatching pour définir une file d’attente d’E/S pour recevoir toutes les demandes de création de fichiers (type de requête WdfRequestTypeCreate ). Le pilote recevra ensuite des demandes de création de fichiers dans le gestionnaire de requêtes EvtIoDefault de la file d’attente.

Pour plus d’informations sur les objets de fichier d’infrastructure, consultez Framework File Objects.

Pour plus d’informations sur les noms de fichiers, consultez Contrôle de l’accès à l’espace de noms des appareils.

Pour plus d’informations sur les chaînes de référence, consultez IoRegisterDeviceInterface.

Exemples

L’exemple de code suivant montre comment une fonction de rappel EvtDeviceFileCreate peut obtenir le nom du fichier qu’une application a ouvert.

VOID
MyEvtDeviceFileCreate (
    IN WDFDEVICE  Device,
    IN WDFREQUEST  Request,
    IN WDFFILEOBJECT  FileObject
    )
{
    PUNICODE_STRING  fileName;

    fileName = WdfFileObjectGetFileName(FileObject);
...

}

Configuration requise

Condition requise Valeur
Plateforme cible Universal
Version KMDF minimale 1.0
Version UMDF minimale 2.0
En-tête wdffileobject.h (inclure Wdf.h)
Bibliothèque Wdf01000.sys (KMDF) ; WUDFx02000.dll (UMDF)
IRQL PASSIVE_LEVEL
Règles de conformité DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Voir aussi

UNICODE_STRING

WdfDeviceCreateDeviceInterface