Bagikan melalui


Metode IPnpCallbackHardware2::OnPrepareHardware (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 OnPrepareHardware melakukan operasi apa pun yang diperlukan untuk membuat perangkat dapat diakses oleh driver.

Sintaks

HRESULT OnPrepareHardware(
  [in] IWDFDevice3        *pWdfDevice,
  [in] IWDFCmResourceList *pWdfResourcesRaw,
  [in] IWDFCmResourceList *pWdfResourcesTranslated
);

Parameter

[in] pWdfDevice

Penunjuk ke antarmuka IWDFDevice3 untuk objek perangkat kerangka kerja.

[in] pWdfResourcesRaw

Penunjuk ke antarmuka IWDFCmResourceList untuk objek daftar sumber daya kerangka kerja yang mengidentifikasi sumber daya perangkat keras mentah yang telah ditetapkan manajer Plug and Play ke perangkat.

[in] pWdfResourcesTranslated

Penunjuk ke antarmuka IWDFCmResourceList untuk objek daftar sumber daya kerangka kerja yang mengidentifikasi sumber daya perangkat keras yang diterjemahkan yang telah ditetapkan manajer Plug and Play ke perangkat.

Nilai kembali

OnPrepareHardware mengembalikan S_OK jika operasi berhasil. Jika tidak, metode ini mengembalikan salah satu kode kesalahan yang ditentukan dalam Winerror.h. Jangan mengembalikan HRESULT_FROM_NT(STATUS_NOT_SUPPORTED).

Jika OnPrepareHardware mengembalikan kode kesalahan, kerangka kerja akan tetap memanggil metode IPnpCallbackHardware2::OnReleaseHardware . Metode OnReleaseHardware kemudian dapat membebaskan sumber daya yang dialokasikan selama panggilan ke OnPrepareHardware. Karena OnReleaseHardware harus membebaskan sumber daya untuk kasus keberhasilan dan kegagalan OnPrepareHardware, OnReleaseHardware harus dapat menangani pembersihan sumber daya parsial.

Keterangan

Metode IPnpCallbackHardware2::OnPrepareHardware berbeda dari metode IPnpCallbackHardware::OnPrepareHardware karena menerima sumber daya mentah dan diterjemahkan.

Untuk informasi tentang mengurai sumber daya perangkat keras, lihat Menemukan dan Memetakan Sumber Daya Perangkat Keras di Driver UMDF.

Contoh

Lihat contoh kode di IWDFDevice3::MapIoSpace.

Persyaratan

Persyaratan Nilai
Akhir dukungan Tidak tersedia di UMDF 2.0 dan yang lebih baru.
Target Platform Desktop
Versi UMDF minimum 1.11
Header wudfddi.h

Lihat juga

IPnpCallbackHardware2

OnReleaseHardware