Metode IWDFIoRequest::GetFileObject (wudfddi.h)
[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 GetFileObject mengambil pointer ke antarmuka IWDFFile yang terkait dengan permintaan I/O.
Sintaks
void GetFileObject(
[out] IWDFFile **ppFileObject
);
Parameter
[out] ppFileObject
Penunjuk ke buffer yang menerima penunjuk ke antarmuka IWDFFile untuk objek file. Perhatikan bahwa mengembalikan NULL valid.
Nilai kembali
Tidak ada
Keterangan
Saat driver Anda memanggil GetFileObject, kerangka kerja akan menaikkan jumlah referensi pada antarmuka. Driver Anda bertanggung jawab untuk merilis referensi setelah selesai dengan penunjuk antarmuka. Untuk melakukannya, gunakan penunjuk cerdas yang secara otomatis mengurangi jumlah referensi saat objek keluar dari konteks, atau panggil Rilis pada antarmuka setelah selesai.
Contoh
Contoh kode berikut diambil dari sampel WpdMultiTransportDriver di WDK. Contoh mendeklarasikan penunjuk cerdas ke antarmuka IWDFFile , memanggil GetFileObject, lalu memanggil RetrieveContext pada objek file.
CComPtr<IWDFFile> pFileObject;
...
// Get the Context map for this client
pRequest->GetFileObject(&pFileObject);
if (pFileObject != NULL)
{
hr = pFileObject->RetrieveContext((void**)&pClientContextMap);
CHECK_HR(hr, "Failed to get Contextmap from WDF File Object");
}
Persyaratan
Persyaratan | Nilai |
---|---|
Akhir dukungan | Tidak tersedia di UMDF 2.0 dan yang lebih baru. |
Target Platform | Desktop |
Versi UMDF minimum | 1,5 |
Header | wudfddi.h (termasuk Wudfddi.h) |
DLL | WUDFx.dll |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk