WdfRequestGetFileObject, fonction (wdfrequest.h)

[S’applique à KMDF et UMDF]

La méthode WdfRequestGetFileObject récupère l’objet de fichier framework associé à une requête d’E/S spécifiée.

Syntaxe

WDFFILEOBJECT WdfRequestGetFileObject(
  [in] WDFREQUEST Request
);

Paramètres

[in] Request

Handle vers un objet de requête de framework.

Valeur de retour

WdfRequestGetFileObject retourne un handle à l’objet de fichier framework, si l’infrastructure a créé un objet de fichier pour la requête spécifiée. Sinon, cette méthode retourne NULL . (Un pilote teste généralement un NULL valeur de retour uniquement si elle définit l’indicateur de bits WdfFileObjectCanBeOptional dans la structure WDF_FILEOBJECT_CONFIG.)

Une vérification de bogue se produit si le pilote fournit un handle d’objet non valide.

Remarques

La méthode WdfRequestGetFileObject retourne NULL si :

• Votre pilote n’a pas appelé WdfDeviceInitSetFileObjectConfig et spécifié une valeur WDF_FILEOBJECT_CLASS qui provoque la création d’objets de fichier par l’infrastructure.
• Un autre pilote a envoyé une demande de contrôle de lecture, d’écriture ou d’E/S à votre pilote sans d’abord envoyer un type de requête de WdfRequestTypeCreate.

Exemples

L’exemple de code suivant obtient l’objet de fichier d’une requête d’E/S, puis appelle une routine définie par le pilote qui obtient un pointeur vers l’espace de contexte de l’objet de fichier.

VOID
MyEvtIoWrite(
    IN WDFQUEUE  Queue,
    IN WDFREQUEST  Request,
    IN size_t  Length
    )
{
    WDFFILEOBJECT  fileObject;
    PFILE_OPEN_CONTEXT  pOpenContext;

    fileObject = WdfRequestGetFileObject(Request);
    pOpenContext = GetFileObjectContext(fileObject)->OpenContext;
}

Exigences

Voir aussi

WDF_FILEOBJECT_CLASS

WdfDeviceInitSetFileObjectConfig