Fungsi panggilan balik pHalSetSystemInformation (ntddk.h)

  • Artikel

Daftarkan driver MCA dengan HAL.

Sintaks

pHalSetSystemInformation Phalsetsysteminformation;

NTSTATUS Phalsetsysteminformation(
  [in]  HAL_SET_INFORMATION_CLASS InformationClass,
  [in]  ULONG BufferSize,
  [out] PVOID Buffer
)
{...}

Parameter

[in] InformationClass

HalMcaRegisterDriver untuk mendaftarkan rutinitas panggilan balik driver MCA dengan HAL. Ada dua rutinitas panggilan balik: ExceptionCallback dan DpcCallback. Rutinitas ExceptionCallback dipanggil selama pemrosesan kesalahan yang tidak dapat dimulai ulang oleh handler Machine Check Exception (MCE), sebelum mengeluarkan pemeriksaan bug untuk sistem. Rutinitas DpcCallback dipanggil ketika kesalahan MCA dapat dimulai ulang. Untuk sistem Itanium, tentukan HalCmcRegisterDriver untuk mendaftarkan rutinitas DpcCallback Kesalahan CPU yang Dikoreksi driver, dan HalCpeRegisterDriver untuk mendaftarkan DpcCallback Kesalahan Platform yang Dikoreksi driver.

[in] BufferSize

Ukuran, dalam byte, dari buffer yang disediakan pemanggil.

[out] Buffer

Penunjuk ke buffer jenis MCA_DRIVER_INFO yang disediakan penelepon, yang didefinisikan sebagai berikut.

typedef struct _MCA_DRIVER_INFO {
  PDRIVER_EXCPTN_CALLBACK  ExceptionCallback; // NULL for Itanium corrected error registration
  PKDEFERRED_ROUTINE  DpcCallback;
  PVOID  DeviceContext;
} MCA_DRIVER_INFO, *PMCA_DRIVER_INFO;

Struktur ini berisi anggota berikut:

  • ExceptionCallback

    Rutinitas yang disediakan driver untuk dipanggil ketika Pengecualian Pemeriksaan Mesin (MCE) terjadi untuk kesalahan yang tidak dikoreksi. Driver secara eksplisit tidak dapat menggunakan layanan kernel atau rutinitas kunci putar. Handler dibatasi untuk batasan yang sama dengan driver yang beroperasi pada IRQL tertinggi.

  • DpcCallback

    Rutinitas yang disediakan driver yang dipanggil untuk kesalahan yang diperbaiki yang menyebabkan Machine Check Exception (MCE). Rutinitas ini harus dipanggil pada DISPATCH_LEVEL.

  • DeviceContext

    Konteks khusus perangkat untuk driver MCA ini.

Nilai kembali

Mengembalikan STATUS_SUCCESS jika pendaftaran berhasil.

Keterangan

HalSetSystemInformation harus dipanggil sebelum driver MCA dapat menggunakan salah satu rutinitas antarmuka lainnya. Hanya satu driver MCA yang dapat didaftarkan ke HAL pada waktu tertentu.

Windows Vista dan versi Windows yang lebih baru tidak mendukung jenis Pelaporan Machine Check Architecture (MCA) dan Machine Check Exception (MCE) yang dijelaskan dalam topik ini. Pelaporan MCA dan MCE didukung melalui Windows Hardware Error Architecture (WHEA).

Persyaratan

Persyaratan Nilai
Target Platform Desktop
Header ntddk.h (termasuk Ntddk.h)