WdfDeviceGetFileObject, fonction (wdfdevice.h)

Article
03/01/2024

[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