Metode IWDFFile2::GetRelatedFileObject (wudfddi.h)

Artikel
02/27/2024

[Peringatan: UMDF 2 adalah versi terbaru UMDF dan pengganti UMDF 1. Semua driver UMDF baru harus ditulis menggunakan UMDF 2. Tidak ada fitur baru yang ditambahkan ke UMDF 1 dan ada dukungan terbatas untuk UMDF 1 pada versi Windows 10 yang lebih baru. Driver Universal Windows harus menggunakan UMDF 2. Untuk informasi selengkapnya, lihat Mulai menggunakan UMDF.]

Metode GetRelatedFileObject mengambil antarmuka IWDFFile dari objek file terkait, yang merupakan objek file yang memiliki hubungan khusus teknologi dengan objek file lain.

Sintaks

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

Parameter

[out] ppRelatedFileObj

Alamat lokasi yang menerima penunjuk ke antarmuka IWDFFile dari objek file UMDF. Objek file ini terkait dengan objek file yang mengekspos antarmuka IWDFFile2 induk antarmuka IWDFFile .

Nilai kembali

Tidak ada

Keterangan

Penggunaan objek file terkait bersifat khusus teknologi. Misalnya, streaming kernel menggunakan objek file terkait untuk mewakili filter induk pin anak.

Untuk informasi selengkapnya tentang objek file terkait, lihat anggota GetRelatedFileObject dari struktur FILE_OBJECT mode kernel.

Contoh

Contoh kode berikut mengambil antarmuka IWDFFile dari objek file terkait, dari antarmuka IWDFFile yang diterima oleh fungsi panggilan balik IQueueCallbackCreate::OnCreateFile 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);
    ...

Persyaratan

Persyaratan	Nilai
Akhir dukungan	Tidak tersedia di UMDF 2.0 dan yang lebih baru.
Target Platform	Desktop
Versi UMDF minimum	1.9
Header	wudfddi.h (termasuk Wudfddi.h)
DLL	WUDFx.dll

Lihat juga

IWDFFile2

Bagikan melalui