EVT_ACX_FACTORY_CIRCUIT_PREPARE_HARDWARE fungsi panggilan balik (acxcircuit.h)
Panggilan balik EVT_ACX_FACTORY_CIRCUIT_PREPARE_HARDWARE digunakan oleh driver untuk menambahkan fungsionalitas ketika pabrik sirkuit sedang dalam fase persiapan perangkat keras.
Sintaks
EVT_ACX_FACTORY_CIRCUIT_PREPARE_HARDWARE EvtAcxFactoryCircuitPrepareHardware;
NTSTATUS EvtAcxFactoryCircuitPrepareHardware(
WDFDEVICE Device,
ACXFACTORYCIRCUIT Factory,
WDFCMRESLIST ResourcesRaw,
WDFCMRESLIST ResourcesTranslated
)
{...}
Parameter
Device
Objek WDFDEVICE (dijelaskan dalam Ringkasan Objek Kerangka Kerja) yang terkait dengan sirkuit ACX.
Factory
Pabrik sirkuit yang ada ACXFACTORYCIRCUIT Object. Untuk informasi selengkapnya tentang objek ACX, lihat Ringkasan Objek ACX.
ResourcesRaw
Daftar sumber daya WDF yang menjelaskan sumber daya mentah yang akan digunakan untuk fase persiapan perangkat keras. Ini adalah objek daftar sumber daya kerangka kerja WDF yang mewakili daftar sumber daya perangkat keras untuk perangkat. Untuk informasi selengkapnya tentang sumber daya mentah, lihat Sumber Daya Perangkat Keras untuk Driver Framework-Based.
ResourcesTranslated
Daftar sumber daya WDF yang menjelaskan sumber daya yang diterjemahkan yang akan digunakan untuk fase persiapan perangkat keras. Ini adalah objek daftar sumber daya kerangka kerja WDF yang mewakili daftar sumber daya perangkat keras untuk perangkat. Untuk informasi selengkapnya tentang daftar sumber daya yang diterjemahkan, lihat Sumber Daya Mentah dan Terjemahan.
Menampilkan nilai
Mengembalikan STATUS_SUCCESS jika panggilan berhasil. Jika tidak, ia mengembalikan kode kesalahan yang sesuai. Untuk informasi selengkapnya, lihat Menggunakan Nilai NTSTATUS.
Keterangan
Untuk mendaftarkan fungsi panggilan balik EvtAcxFactoryCircuitPrepareHardware, driver harus memanggil metode AcxFactoryCircuitInitSetAcxCircuitPnpowerCallbacks.
Jika driver telah mendaftarkan fungsi panggilan balik EvtAcxFactoryCircuitPrepareHardware untuk ACXFACTORYCIRCUIT, kerangka kerja ACX memanggil fungsi setelah kerangka kerja WDF memanggil fungsi panggilan balik EvtDevicePrepareHardware driver.
Fungsi panggilan balik EvtAcxFactoryCircuitPrepareHardware mengakses sumber daya perangkat keras mentah dan terjemahan perangkat dengan menggunakan penanganan ResourcesRaw dan ResourcesTranslated yang diterimanya. Fungsi panggilan balik dapat memanggil WdfCmResourceListGetCount dan WdfCmResourceListGetDescriptor untuk melintasi daftar sumber daya. Fungsi panggilan balik ini tidak dapat mengubah daftar sumber daya.
Untuk informasi selengkapnya tentang daftar sumber daya dan urutan sumber daya muncul, lihat Sumber Daya Mentah dan Terjemahan.
Biasanya, fungsi panggilan balik EvtAcxFactoryCircuitPrepareHardware driver Anda melakukan hal berikut, jika perlu:
- Memetakan alamat memori fisik ke alamat virtual ACXFACTORYCIRCUIT sehingga driver dapat mengakses memori yang ditetapkan ke perangkat.
- Secara opsional, fungsi panggilan balik EvtAcxFactoryCircuitPrepareHardware driver Anda mungkin mengantre item kerja untuk menyelesaikan tugas konfigurasi intensif waktu lainnya. Menggunakan item kerja untuk operasi tersebut dapat membantu memastikan bahwa waktu mulai perangkat Anda tidak meningkatkan waktu boot sistem. Untuk informasi selengkapnya, lihat Menggunakan Item Kerja Kerangka Kerja.
- Biasanya, semua operasi inisialisasi perangkat keras lainnya, termasuk memuat firmware, harus berlangsung setiap kali perangkat memasuki status berfungsi (D0) dan karenanya harus berlangsung dalam fungsi panggilan balik EvtDeviceD0Entry driver.
ResourcesRaw dan ResourcesTranslated menangani bahwa fungsi panggilan balik EvtAcxCircuitPrepareHardware/EvtDevicePrepareHardware menerima tetap valid sampai fungsi panggilan balik EvtDeviceReleaseHardware driver kembali.
Jika driver gagal panggilan balik EvtAcxFactoryCircuitPrepareHardware, objek ACXFACTORYCIRCUIT ditempatkan dalam status hapus-tertunda.
Untuk informasi selengkapnya tentang sumber daya perangkat keras, lihat Pengantar Sumber Daya Perangkat Keras.
Untuk informasi selengkapnya tentang kapan kerangka kerja ACX dan WDF memanggil fungsi panggilan balik ini, lihat Skenario PnP dan Power Management.
Untuk informasi selengkapnya tentang driver yang menyediakan fungsi panggilan balik ini, lihat Mendukung PnP dan Manajemen Daya di Driver Fungsi.
Persyaratan ACX
Versi ACX minimum: 1.0
Untuk informasi selengkapnya tentang versi ACX, lihat Gambaran umum versi ACX.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Header | acxcircuit.h |
| IRQL | PASSIVE_LEVEL |