Fungsi PoFxPowerOnCrashdumpDevice (wdm.h)

  • Artikel

PoFxPowerOnCrashdumpDevice rutin meminta agar perangkat crash-dump diaktifkan.

Sintaks

NTSTATUS PoFxPowerOnCrashdumpDevice(
  [in]           POHANDLE Handle,
  [in, optional] PVOID    Context
);

Parameter

[in] Handle

Handel yang mewakili pendaftaran perangkat crash-dump dengan kerangka kerja manajemen daya Windows (PoFx). Driver perangkat sebelumnya menerima handel ini dari rutinitas PoFxRegisterDevice .

[in, optional] Context

Penunjuk ke konteks khusus perangkat. Pointer ini diteruskan sebagai parameter input ke rutinitas panggilan balik PowerOnDumpDeviceCallback yang diimplementasikan oleh plug-in ekstensi platform (PEP) untuk perangkat. Informasi konteks disimpan dalam format yang ditentukan oleh driver perangkat dan dipahami oleh PEP. Konteks ini buram untuk sistem operasi. Driver dapat mengatur parameter ini ke NULL jika PEP tidak memerlukan konteks.

Menampilkan nilai

PoFxPowerOnCrashdumpDevice mengembalikan STATUS_SUCCESS jika rutinitas berhasil menyalakan daya ke perangkat. Kemungkinan nilai pengembalian kesalahan mencakup kode status berikut.

Mengembalikan nilai Deskripsi
STATUS_INVALID_PARAMETER
 Bukan nilai handel yang valid.
STATUS_UNSUCCESSFUL
 PEP untuk perangkat ini tidak mengimplementasikan rutinitas panggilan balik PowerOnDumpDeviceCallback ; atau PEP gagal menyalakan perangkat.

Keterangan

Driver untuk perangkat crash-dump memanggil rutinitas ini untuk meminta agar plug-in ekstensi platform (PEP) menyalakan perangkat sehingga crash dump dapat disimpan. Semua perangkat dalam rantai perangkat crash-dump (yang mungkin mencakup pengontrol penyimpanan, pengontrol PCI, dan sebagainya) harus diaktifkan sebelum file crash-dump dapat ditulis ke disk.

Untuk informasi selengkapnya tentang crash dump, lihat File Cadangan Mode Kernel.

Rutinitas ini dapat dipanggil di IRQL <= HIGH_LEVEL.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia dimulai dengan Windows 8.1.
Target Platform Windows
Header wdm.h (termasuk Pepfx.h)
Pustaka Ntoskrnl.lib
IRQL <= HIGH_LEVEL

Lihat juga

PoFxRegisterDevice

PowerOnDumpDeviceCallback