Share via

EVT_ACX_FACTORY_CIRCUIT_POWER_DOWN fungsi panggilan balik (acxcircuit.h)

  • Artikel

Panggilan balik EVT_ACX_FACTORY_CIRCUIT_POWER_DOWN digunakan oleh driver untuk menambahkan fungsionalitas di jalur matikan objek ACXFACTORYCIRCUIT.

Sintaks

EVT_ACX_FACTORY_CIRCUIT_POWER_DOWN EvtAcxFactoryCircuitPowerDown;

NTSTATUS EvtAcxFactoryCircuitPowerDown(
  WDFDEVICE Device,
  ACXFACTORYCIRCUIT Factory,
  WDF_POWER_DEVICE_STATE TargetState
)
{...}

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.

TargetState

Enumerasi WDF_POWER_DEVICE_STATE yang mengidentifikasi status daya perangkat target.

Menampilkan nilai

Mengembalikan STATUS_SUCCESS jika panggilan berhasil. Jika tidak, kode kesalahan akan menampilkan kode kesalahan yang sesuai. Untuk informasi selengkapnya, lihat Menggunakan Nilai NTSTATUS.

Keterangan

Untuk mendaftarkan fungsi panggilan balik EvtAcxFactoryCircuitPrepareHardware, driver harus memanggil AcxFactoryCircuitInitSetAcxCircuitPnpowerCallbacks.

Jika driver telah mendaftarkan fungsi panggilan balik EvtCircuitPowerDown, kerangka kerja ACX memanggil fungsi setiap kali salah satu perangkat driver meninggalkan status berfungsi (D0). Perangkat meninggalkan status D0 saat salah satu hal berikut ini terjadi:

  • Sistem dan semua perangkatnya akan meninggalkan status kerjanya dan memasuki status daya rendah.
  • Perangkat akan memasuki status daya rendah karena diam, jika perangkat mendukung diam berdaya rendah.
  • Manajer Plug and Play mencoba mendistribusikan ulang sumber daya perangkat keras sistem.
  • Pengguna telah menunjukkan, biasanya melalui antarmuka pengguna aplikasi, bahwa dia ingin menghapus perangkat.
  • Kerangka kerja ini juga memanggil fungsi panggilan balik EvtFactoryCircuitPowerDown setelah perangkat dihapus secara tiba-tiba (dihapus secara mendadak).

Untuk informasi selengkapnya tentang kapan kerangka kerja memanggil fungsi panggilan balik ini, lihat Skenario Manajemen PnP dan Power.

Kecuali perangkat telah dihapus secara mendadak, kerangka kerja ACX memanggil fungsi panggilan balik ini segera setelah menonaktifkan gangguan perangkat, tetapi sebelum daya perangkat dikurangi dari D0 dan sebelum WDF memanggil panggilan balik EvtDeviceD0Exit driver pada perangkat terkait. Parameter TargetState mengidentifikasi status daya perangkat yang akan dimasukkan perangkat.

Fungsi panggilan balik EvtFactoryCircuitPowerDown harus melakukan operasi apa pun yang diperlukan sebelum perangkat keras ACXFACTORYCIRCUT memasuki status daya rendah yang ditentukan, seperti menyimpan informasi apa pun yang diperlukan driver nanti untuk memulihkan perangkat keras ACXFACTORYCIRCUIT ke status daya D0-nya.

Jika TargetState adalah WdfPowerDeviceD3Final, Anda harus berasumsi bahwa sistem sedang dimatikan, perangkat terkait akan dihapus, atau penyeimbangan ulang sumber daya sedang berlangsung. Jika driver Anda harus menyimpan informasi, driver harus menulisnya ke disk atau media penyimpanan permanen lainnya.

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

Lihat juga