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

Lihat juga

IWDFIoQueue::GetDevice

IWDFObject

IWDFObject::AssignContext