Fungsi PshedSynchronizeExecution (ntddk.h)

Artikel
02/26/2024

Fungsi PshedSynchronizeExecution menyinkronkan eksekusi fungsi tertentu dengan pemrosesan kesalahan perangkat keras untuk sumber kesalahan.

Sintaks

NTPSHEDAPI BOOLEAN PshedSynchronizeExecution(
  [in] PWHEA_ERROR_SOURCE_DESCRIPTOR ErrorSource,
  [in] PKSYNCHRONIZE_ROUTINE         SynchronizeRoutine,
  [in] PVOID                         SynchronizeContext
);

Parameter

[in] ErrorSource

Penunjuk ke struktur WHEA_ERROR_SOURCE_DESCRIPTOR yang menjelaskan sumber kesalahan.

[in] SynchronizeRoutine

Penunjuk ke fungsi yang disediakan penelepon yang eksekusinya disinkronkan dengan pemrosesan kesalahan perangkat keras untuk sumber kesalahan yang dijelaskan oleh parameter ErrorSource . Fungsi SynchronizeRoutine dinyatakan sebagai berikut:

BOOLEAN
SynchronizeRoutine(
    _In_ PVOID  SynchronizeContext
    );

SynchronizeContext

Nilai konteks yang diteruskan dalam parameter SynchronizeContext ke fungsi PshedSynchronizeExecution .

[in] SynchronizeContext

Penunjuk ke area konteks yang disediakan penelepon yang diteruskan ke fungsi yang diarahkan oleh parameter SynchronizeRoutine .

Nilai kembali

PshedSynchronizeExecution mengembalikan nilai yang dikembalikan oleh fungsi yang ditunjukkan oleh parameter SynchronizeRoutine .

Keterangan

Plug-in PSHED memanggil fungsi PshedSynchronizeExecution untuk menyinkronkan eksekusi fungsi tertentu dengan pemrosesan kesalahan perangkat keras untuk sumber kesalahan. Ini diperlukan setiap kali plug-in PSHED berbagi sumber daya antara kode yang dijalankan di luar alur pemrosesan kesalahan perangkat keras normal dan kode yang dijalankan sebagai bagian dari alur pemrosesan kesalahan perangkat keras normal. Untuk informasi selengkapnya tentang pemrosesan kesalahan perangkat keras, lihat Pemrosesan Kesalahan.

Ketika fungsi ini dipanggil, hal berikut terjadi:

IRQL dinaikkan ke IRQL tempat handler kesalahan perangkat keras tingkat rendah (LLHEH) untuk sumber kesalahan dijalankan.
Akses ke area konteks yang ditentukan oleh parameter SynchronizeContext disinkronkan dengan LLHEH dengan memperoleh kunci putar terkait.
Fungsi yang ditentukan dalam parameter SynchronizeRoutine dipanggil.

Pemanggil fungsi PshedSynchronizeExecution harus berjalan di IRQL <= DIRQL, yaitu, kurang dari atau sama dengan IRQL tempat LLHEH untuk sumber kesalahan dijalankan.

Persyaratan

Persyaratan	Nilai
Target Platform	Universal
Header	ntddk.h (termasuk Ntddk.h)
Pustaka	Pshed.lib
DLL	Pshed.dll
IRQL	IRQL <= DIRQL

Lihat juga

WHEA_ERROR_SOURCE_DESCRIPTOR

Share via