IWDFFile2 ::GetRelatedFileObject, méthode (wudfddi.h)

Article
02/07/2025

[Avertissement : UMDF 2 est la dernière version de UMDF et remplace UMDF 1. Tous les nouveaux pilotes UMDF doivent être écrits à l’aide de UMDF 2. Aucune nouvelle fonctionnalité n’est ajoutée à UMDF 1 et il existe une prise en charge limitée de UMDF 1 sur les versions plus récentes de Windows 10. Les pilotes Windows universels doivent utiliser UMDF 2. Pour plus d’informations, consultez Bien démarrer avec UMDF.]

La méthode GetRelatedFileObject récupère l’interface IWDFFile d’un objet de fichier associé , qui est un objet de fichier qui a une relation spécifique à la technologie avec un autre objet de fichier.

Syntaxe

void GetRelatedFileObject(
  [out] IWDFFile **ppRelatedFileObj
);

Paramètres

[out] ppRelatedFileObj

Adresse d’un emplacement qui reçoit un pointeur vers l’interface IWDFFile d’un objet de fichier UMDF. Cet objet de fichier est lié à l’objet de fichier qui expose l’interface IWDFFile2 l’interface parente IWDFFile.

Valeur de retour

Aucun

Remarques

L’utilisation d’objets de fichiers associés est spécifique à la technologie. Par exemple, diffusion en continu du noyau utilise des objets de fichier associés pour représenter les filtres parents des broches enfants.

Pour plus d’informations sur les objets de fichiers associés, consultez la GetRelatedFileObject membre de la structure FILE_OBJECT en mode noyau.

Exemples

L’exemple de code suivant récupère l’interface IWDFFile d’un objet de fichier associé, à partir de l’interface IWDFFile qu’une fonction de rappel IQueueCallbackCreate ::OnCreateFile reçoit.

VOID
STDMETHODCALLTYPE
CMyQueue::OnCreateFile(
    __in IWDFIoQueue *pWdfQueue,
    __in IWDFIoRequest *pWdfRequest,
    __in IWDFFile*  pWdfFileObject
    )
 ...
    IWDFFile*  pWdfRelatedFileObject = NULL;
    IWDFFile2*  pWdfFileObject2 = NULL;
    HRESULT  hr = S_OK;

    //
    // Obtain IWDFFile2 interface from IWDFFile.
    //
    hr = pWdfFileObject->QueryInterface(IID_PPV_ARGS(&pWdfFileObject2));
    if (!SUCCEEDED(hr))
    {
        goto Done;
    }
    pWdfFileObject2->GetRelatedFileObject(&pWdfRelatedFileObject);
    ...

Exigences

Exigence	Valeur
fin du support	Indisponible dans UMDF 2.0 et versions ultérieures.
plateforme cible	Bureau
version minimale de UMDF	1.9
d’en-tête	wudfddi.h (include Wudfddi.h)
DLL	WUDFx.dll

Voir aussi

IWDFFile2

Partager via