Metode IPnpCallbackRemoteInterfaceNotification::OnRemoteInterfaceArrival (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.]

Fungsi panggilan balik peristiwa OnRemoteInterfaceArrival driver memberi tahu driver ketika antarmuka perangkat tersedia.

Sintaks

void OnRemoteInterfaceArrival(
  [in] IWDFRemoteInterfaceInitialize *pWdfRemoteInterfaceInit
);

Parameter

[in] pWdfRemoteInterfaceInit

Penunjuk ke antarmuka IWDFRemoteInterfaceInitialize yang mengidentifikasi antarmuka perangkat yang telah tiba.

Nilai kembali

Tidak ada

Keterangan

Driver berbasis UMDF dapat mendaftarkan fungsi panggilan balik peristiwa OnRemoteInterfaceArrival opsional dengan memanggil IWDFDevice2::RegisterRemoteInterfaceNotification.

Driver dapat menggunakan metode antarmuka IWDFRemoteInterfaceInitialize untuk menentukan antarmuka perangkat mana yang telah tiba.

Sebelum driver dapat mengirim permintaan I/O ke antarmuka perangkat, driver harus melakukan hal berikut:

Panggil IWDFDevice2::CreateRemoteInterface untuk membuat objek antarmuka jarak jauh.
Panggil IWDFDevice2::CreateRemoteTarget untuk membuat objek target jarak jauh.
Panggil IWDFRemoteTarget::OpenRemoteInterface untuk menyambungkan objek antarmuka ke objek target jarak jauh dan buka target jarak jauh untuk operasi I/O.

Untuk informasi selengkapnya tentang menggunakan objek antarmuka jarak jauh untuk mengakses antarmuka perangkat, lihat Menggunakan Antarmuka Perangkat di Driver berbasis UMDF

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)