Méthode IWDFFile2 ::GetRelatedFileObject (wudfddi.h)

[Avertissement : UMDF 2 est la dernière version d’UMDF et remplace UMDF 1. Tous les nouveaux pilotes UMDF doivent être écrits à l’aide d’UMDF 2. Aucune nouvelle fonctionnalité n’est ajoutée à UMDF 1 et la prise en charge d’UMDF 1 est limitée sur les versions plus récentes de Windows 10. Les pilotes Windows universels doivent utiliser UMDF 2. Pour plus d’informations, consultez Prise en main 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 à une 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 file qui expose l’interface IWDFFile2 parente de l’interface IWDFFile .

Valeur de retour

None

Remarques

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

Pour plus d’informations sur les objets de fichiers associés, consultez le membre GetRelatedFileObject de la structure de 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 que reçoit la fonction de rappel IQueueCallbackCreate ::OnCreateFile d’un pilote.

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);
    ...

Configuration requise

Voir aussi

IWDFFile2