Metode IDriverEntry::OnDeviceAdd (wudfddi.h)

Artikel
03/01/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.]

Metode OnDeviceAdd menambahkan perangkat baru ke sistem.

Sintaks

HRESULT OnDeviceAdd(
  [in] IWDFDriver           *pWdfDriver,
  [in] IWDFDeviceInitialize *pWdfDeviceInit
);

Parameter

[in] pWdfDriver

Penunjuk ke antarmuka IWDFDriver untuk objek driver induk tempat perangkat baru berada.

[in] pWdfDeviceInit

Penunjuk ke antarmuka IWDFDeviceInitialize yang digunakan driver untuk menginisialisasi perangkat yang baru dibuat.

Mengembalikan nilai

OnDeviceAdd mengembalikan S_OK jika operasi berhasil. Jika tidak, metode ini mengembalikan salah satu kode kesalahan yang didefinisikan dalam Winerror.h. Driver harus mengembalikan S_OK hanya jika berhasil disebut metode IWDFDriver::CreateDevice untuk membuat objek perangkat kerangka kerja. Jika driver mengembalikan kode kesalahan, UMDF merobek seluruh tumpukan perangkat terlepas dari apakah driver adalah driver filter atau driver fungsi.

Keterangan

Objek perangkat baru dibuat untuk setiap perangkat yang dimuat dalam proses host driver. Ketika perangkat baru tiba di sistem, kerangka kerja memanggil OnDeviceAdd untuk memberi tahu driver kedatangan dan melewati antarmuka IWDFDriver dan IWDFDeviceInitialize dalam panggilan. Driver dapat memanggil metode IWDFDeviceInitialize::RetrieveDevicePropertyStore untuk meminta informasi perangkat yang disediakan sebagai bagian dari penginstalan perangkat. Driver harus memanggil metode IWDFDriver::CreateDevice untuk mengonfigurasi dan membuat perangkat. Jika driver tidak berhasil memanggil IWDFDriver::CreateDevice sebelum mengembalikan S_OK, UMDF menentukan bahwa perilaku driver salah dan mengakhiri proses host.

Setiap driver yang metode OnDeviceAdd-nya mengembalikan S_OK kemudian akan menerima panggilan ke metode IPnpCallbackHardware::OnReleaseHardware ketika UMDF merobek tumpukan perangkat.

Jangan gunakan antarmuka IWDFDeviceInitialize yang dirujuk parameter pWdfDeviceInit setelah driver memanggil IWDFDriver::CreateDevice.

Untuk informasi selengkapnya, lihat Menambahkan Perangkat.