Metodo IWDFFile2::GetRelatedFileObject (wudfddi.h)

Articolo
02/27/2024

[Avviso: UMDF 2 è la versione più recente di UMDF e sostituisce UMDF 1. Tutti i nuovi driver UMDF devono essere scritti usando UMDF 2. Non vengono aggiunte nuove funzionalità a UMDF 1 ed è disponibile un supporto limitato per UMDF 1 nelle versioni più recenti di Windows 10. I driver di Windows universali devono usare UMDF 2. Per altre info, vedi Introduzione con UMDF.]

Il metodo GetRelatedFileObject recupera l'interfaccia IWDFFile di un oggetto file correlato, ovvero un oggetto file con una relazione specifica della tecnologia con un altro oggetto file.

Sintassi

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

Parametri

[out] ppRelatedFileObj

Indirizzo di un percorso che riceve un puntatore all'interfaccia IWDFFile di un oggetto file UMDF. Questo oggetto file è correlato all'oggetto file che espone l'interfaccia IWDFFile2 padre dell'interfaccia IWDFFile .

Valore restituito

nessuno

Osservazioni

L'uso di oggetti file correlati è specifico della tecnologia. Ad esempio, lo streaming del kernel usa oggetti file correlati per rappresentare i filtri padre dei pin figlio.

Per altre informazioni sugli oggetti file correlati, vedere il membro GetRelatedFileObject della struttura FILE_OBJECT in modalità kernel.

Esempio

Nell'esempio di codice seguente viene recuperata l'interfaccia IWDFFile di un oggetto file correlato dall'interfaccia IWDFFile ricevuta dalla funzione di callback IQueueCallbackCreate::OnCreateFile di un driver.

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

Requisiti

Requisito	Valore
Fine del supporto	Non disponibile in UMDF 2.0 e versioni successive.
Piattaforma di destinazione	Desktop
Versione UMDF minima	1,9
Intestazione	wudfddi.h (include Wudfddi.h)
DLL	WUDFx.dll

Vedi anche

IWDFFile2

Condividi tramite