WdfDeviceGetFileObject, fonction (wdfdevice.h)

Article
02/07/2025

[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 vers un objet d’appareil framework.

[in] FileObject

Pointeur vers une structure de FILE_OBJECT WDM.

Valeur de retour

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

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

Remarques

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

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;
}

Exigences

Exigence	Valeur
plateforme cible	Universel
version minimale de KMDF	1.0
d’en-tête	wdfdevice.h (include Wdf.h)
bibliothèque	Wdf01000.sys (voir Versioning de la bibliothèque Framework.)
IRQL	<= DISPATCH_LEVEL
règles de conformité DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Voir aussi

IoGetDeviceObjectPointer

Partager via