Bagikan melalui

Fungsi KeRestoreExtendedProcessorState (wdm.h)

  • Artikel

Rutinitas KeRestoreExtendedProcessorState memulihkan informasi status prosesor yang diperluas yang sebelumnya disimpan.

Sintaks

void KeRestoreExtendedProcessorState(
  [in] PXSTATE_SAVE XStateSave
);

Parameter

[in] XStateSave

Penunjuk ke struktur XSTATE_SAVE yang berisi informasi status prosesor yang diperluas untuk dipulihkan. Isi struktur ini sebelumnya harus disimpan oleh rutinitas KeSaveExtendedProcessorState .

Nilai kembali

Tidak ada

Keterangan

Kode driver mode kernel harus memastikan bahwa panggilan ke KeSaveExtendedProcessorState dan KeRestoreExtendedProcessorState ditumpuk dengan benar. Ini diperlukan agar, pada setiap tingkat bersarang, status yang dipulihkan oleh panggilan KeRestoreExtendedProcessorState adalah status yang sama yang disimpan oleh panggilan KeSaveExtendedProcessorState yang sesuai. Untuk memastikan penumpasan yang tepat, kode driver mode kernel harus mengikuti aturan berikut:

  • Panggilan KeRestoreExtendedProcessorState yang memulihkan status tersimpan harus berjalan di IRQL yang sama dengan panggilan KeSaveExtendedProcessorState yang menyimpan status.
  • Jika sepasang panggilan KeSaveExtendedProcessorState dan KeRestoreExtendedProcessorState ditumpuk dalam sepasang panggilan sekitarnya KeSaveExtendedProcessorState dan KeRestoreExtendedProcessorState , IRQL untuk panggilan berlapis tidak boleh lebih rendah dari IRQL untuk panggilan di sekitarnya.
  • Biasanya, struktur XSTATE_SAVE yang dialokasikan penelepon yang berisi status yang disimpan oleh KeSaveExtendedProcessorState berada di tumpukan. Tumpukan secara alami mempertahankan bersarangnya informasi status yang disimpan. Jika kode driver menyimpan status di lokasi selain tumpukan, penulis driver harus berhati-hati untuk mempertahankan penumpukan panggilan KeSaveExtendedProcessorState dan KeRestoreExtendedProcessorState .
  • Panggilan KeRestoreExtendedProcessorState yang memulihkan status tersimpan harus berjalan di utas yang sama dengan panggilan KeSaveExtendedProcessorState yang menyimpan status.
Serangkaian aturan serupa berlaku untuk rutinitas KeSaveFloatingPointState dan KeRestoreFloatingPointState .

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia di Windows 7 dan versi Windows yang lebih baru.
Target Platform Universal
Header wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)
Pustaka NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL (lihat bagian Keterangan)

Lihat juga

KeRestoreFloatingPointState

KeSaveExtendedProcessorState

KeSaveFloatingPointState

XSTATE_SAVE