Metode IWDFObject::RetrieveContext (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 RetrieveContext mengambil konteks yang sebelumnya terdaftar melalui metode IWDFObject::AssignContext .
Sintaks
HRESULT RetrieveContext(
[out] void **ppvContext
);
Parameter
[out] ppvContext
Penunjuk ke buffer yang menerima penunjuk ke konteks yang terdaftar sebelumnya.
Nilai kembali
RetrieveContext mengembalikan S_OK jika operasi berhasil. Jika tidak, metode ini mengembalikan salah satu kode kesalahan yang didefinisikan dalam Winerror.h.
Keterangan
Karena konteksnya bukan antarmuka Model Objek Komponen (COM), driver tidak boleh memperlakukan konteks seperti itu. Misalnya, driver tidak dapat memanggil metode AddRef pada konteks.
Contoh
Untuk contoh kode tentang cara menggunakan metode RetrieveContext , lihat IWDFIoQueue::GetDevice.
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 |