Partager via


WdfDeviceGetFileObject, fonction (wdfdevice.h)

[S’applique uniquement à KMDF]

La méthode WdfDeviceGetFileObject retourne un handle à l’objet de fichier framework associé à un objet de fichier WDM spécifié.

Syntaxe

WDFFILEOBJECT WdfDeviceGetFileObject(
  [in] WDFDEVICE    Device,
  [in] PFILE_OBJECT FileObject
);

Paramètres

[in] Device

Handle d’un objet d’appareil framework.

[in] FileObject

Pointeur vers une structure de FILE_OBJECT WDM.

Valeur retournée

WdfDeviceGetFileObject retourne un handle à l’objet de fichier framework associé à l’objet de fichier WDM spécifié. Si aucun objet de fichier framework n’a été créé pour le fichier, ou si le pointeur FileObject n’est pas valide, la méthode retourne NULL.

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

Remarques

Pour plus d’informations sur les objets de fichier framework, consultez Objets de fichier framework.

Exemples

L’exemple de code suivant obtient un pointeur vers un objet d’appareil WDM nommé et son objet de fichier WDM correspondant, si l’accès demandé aux objets peut être accordé. Ensuite, l’exemple obtient un handle pour l’objet de fichier framework associé à l’objet de fichier WDM.

PFILE_OBJECT  pWdmFileObject = NULL;
PDEVICE_OBJECT  pWdmDeviceObject = NULL;
WDFFILEOBJECT  fileObject = NULL;
NTSTATUS  status = STATUS_SUCCESS;
BOOLEAN  success = TRUE;

status = IoGetDeviceObjectPointer(
                                  &inputFileName,    // File name 
                                  FILE_ALL_ACCESS,   // Access mask
                                  &pWdmFileObject,   // Output pointer of WDM file object
                                  &pWdmDeviceObject  // Output pointer of WDM device object
                                  );

if(!NT_SUCCESS(status)){
    success = FALSE;
    break;
}

fileObject = WdfDeviceGetFileObject(
                                    gDeviceObject,  // Handle to device object
                                    pWdmFileObject  // Handle to WDM file object
                                    );
if(fileObject == NULL){
    success = FALSE;
}

Configuration requise

Condition requise Valeur
Plateforme cible Universal
Version KMDF minimale 1.0
En-tête wdfdevice.h (include Wdf.h)
Bibliothèque Wdf01000.sys (consultez Gestion de version de la bibliothèque d’infrastructure.)
IRQL <= DISPATCH_LEVEL
Règles de conformité DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Voir aussi

IoGetDeviceObjectPointer