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 |