Metode IWDFDevice2::CreateRemoteTarget (wudfddi.h)

Artikel
08/08/2023

[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 CreateRemoteTarget membuat objek target jarak jauh yang mewakili target I/O jarak jauh.

Sintaks

HRESULT CreateRemoteTarget(
  [in, optional] IUnknown         *pCallbackInterface,
  [in, optional] IWDFObject       *pParentObject,
  [out]          IWDFRemoteTarget **ppRemoteTarget
);

Parameter

[in, optional] pCallbackInterface

Penunjuk ke antarmuka panggilan balik opsional yang disediakan driver. Metode IUnknown::QueryInterface antarmuka ini harus mengembalikan penunjuk ke antarmuka IRemoteTargetCallbackRemoval driver, jika driver mendukung antarmuka tersebut. Parameter ini bersifat opsional dan dapat berupa NULL.

[in, optional] pParentObject

Penunjuk ke objek kerangka kerja. Jika driver menyediakan penunjuk opsional ini, objek yang ditentukan menjadi induk dari objek target jarak jauh baru. Jika parameter ini NULL, objek perangkat yang menyediakan antarmuka IWDFDevice2 menjadi induk. Kerangka kerja akan menghapus objek target jarak jauh saat menghapus objek induk.

[out] ppRemoteTarget

Penunjuk ke lokasi yang menerima penunjuk ke antarmuka IWDFRemoteTarget dari objek target jarak jauh baru.

Nilai kembali

CreateRemoteTarget mengembalikan S_OK jika operasi berhasil. Jika tidak, metode mungkin mengembalikan nilai berikut:

Menampilkan kode	Deskripsi
E_OUTOFMEMORY	Upaya kerangka kerja untuk mengalokasikan memori gagal.
HRESULT_FROM_WIN32 (ERROR_INVALID_PARAMETER)	Parameter pParentObject tidak menentukan objek perangkat yang menyediakan antarmuka IWDFDevice2 atau objek yang rantai induknya mengarah ke objek tersebut.

Metode ini mungkin mengembalikan salah satu nilai lain yang dikandung Winerror.h.

Keterangan

Setelah driver Anda disebut CreateRemoteTarget, driver dapat membuka target jarak jauh dengan memanggil IWDFRemoteTarget::OpenRemoteInterface (untuk membuka antarmuka perangkat) atau IWDFRemoteTarget::OpenFileByName (untuk membuka file).

Jika driver menggunakan parameter pParentObject untuk menentukan objek induk, objek induk dapat menjadi objek perangkat yang menyediakan antarmuka IWDFDevice2 , atau dapat menjadi objek apa pun yang rantai induknya mengarah ke objek perangkat tersebut. Kerangka kerja akan menghapus objek target jarak jauh ketika (atau driver) menghapus objek perangkat.

Untuk informasi selengkapnya tentang target I/O jarak jauh, lihat Menggunakan Target I/O di UMDF.

Contoh

Untuk contoh kode yang menggunakan CreateRemoteTarget, lihat contoh kode di IWDFDevice2::CreateRemoteInterface dan IWDFRemoteTarget::OpenFileByName.

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

IWDFDevice2

IWDFRemoteTarget::OpenFileByName

IWDFRemoteTarget::OpenRemoteInterface

Share via