Fungsi WmiQueryTraceInformation (wdm.h)
Rutinitas WmiQueryTraceInformation
Sintaksis
NTSTATUS WmiQueryTraceInformation(
[in] TRACE_INFORMATION_CLASS TraceInformationClass,
[out] PVOID TraceInformation,
[in] ULONG TraceInformationLength,
[out, optional] PULONG RequiredLength,
[in, optional] PVOID Buffer
);
Parameter
[in] TraceInformationClass
Menentukan enumerator TRACE_INFORMATION_CLASS yang menunjukkan jenis informasi yang akan dikembalikan tentang jejak peristiwa.
[out] TraceInformation
Penunjuk ke buffer output yang dialokasikan pemanggil di mana rutinitas mengembalikan informasi pelacakan peristiwa yang ditentukan oleh TraceInformationClass.
[in] TraceInformationLength
Menentukan ukuran, dalam byte, dari traceInformation buffer.
[out, optional] RequiredLength
Penunjuk ke nilai yang dikembalikan oleh rutinitas yang menentukan ukuran yang diperlukan, dalam byte, dari traceInformation buffer. Pemanggil harus mengatur
[in, optional] Buffer
Penunjuk ke informasi input khusus kueri yang disediakan pemanggil. Jika informasi yang disediakan penelepon tidak diperlukan, pemanggil harus mengatur Buffer ke NULL.
Mengembalikan nilai
Mengembalikan kode | Deskripsi |
---|---|
|
Keberhasilan |
|
Ukuran buffer TraceInformation |
|
Handel pelacakan yang ditentukan oleh anggota |
|
Tipe informasi pelacakan peristiwa yang ditentukan tidak valid. |
|
Nama pelacakan peristiwa, yang disediakan dengan kueri untuk mengembalikan handel pelacakan yang diberikan namanya, tidak valid. |
|
Pemanggil tidak menyediakan informasi yang diperlukan untuk informasi pelacakan peristiwa yang ditentukan. |
|
Buffer TraceInformation |
|
Pencatat global tidak ditemukan. |
Komentar
Untuk setiap jenis informasi pelacakan peristiwa yang ditentukan oleh TraceInformationClass, tabel berikut menyediakan:
- Persyaratan input
-
Informasi yang
WmiQueryTraceInformation dikembalikan dalam buffer TraceInformation
Nilai |
Persyaratan input | Informasi yang dikembalikan |
---|---|---|
|
TraceInformationLength sama dengan nilai sizeof(ULONG).
Ukurannya, dalam byte traceInformation buffer lebih besar dari atau sama dengan nilai sizeof(ULONG). Anggota HistoricalContext dari (PWNODE_HEADER)Buffer menentukan handel pelacakan peristiwa. |
*(PULONG)TraceInformation diatur ke ID pencatat handel pelacakan peristiwa. |
TraceHandleClass |
TraceInformationLength sama dengan nilai sizeof(TRACEHANDLE).
Ukurannya, dalam byte traceInformation buffer harus lebih besar dari atau sama dengan nilai sizeof(TRACEHANDLE). *(PULONG)Buffer diatur ke ID pencatat. |
*(PTRACEHANDLE)TraceInformation diatur ke handel pelacakan peristiwa untuk pencatat yang ditentukan. Jika ID pencatat yang ditentukan adalah nol, handel pelacakan peristiwa untuk pencatat kernel dikembalikan. |
TraceEnableFlagsClass |
Ukurannya, dalam byte traceInformation buffer harus lebih besar dari atau sama dengan nilai sizeof(ULONG). Anggota HistoricalContext dari (PWNODE_HEADER)Buffer menentukan handel pelacakan peristiwa. |
*(PULONG)TraceInformation diatur ke bendera aktifkan yang diatur untuk handel pelacakan peristiwa yang ditentukan. |
TraceEnableLevelClass |
TraceInformationLength diatur lebih besar dari atau sama dengan nilai sizeof(ULONG).
Ukurannya, dalam byte traceInformation buffer harus lebih besar dari atau sama dengan nilai sizeof(ULONG). Anggota HistoricalContext dari (PWNODE_HEADER)Buffer menentukan handel pelacakan peristiwa. |
*(PULONG)TraceInformation diatur ke tingkat untuk handel pelacakan peristiwa yang ditentukan. |
GlobalLoggerHandleClass |
TraceInformationLength sama dengan nilai sizeof(TRACEHANDLE).
Ukurannya, dalam byte traceInformation buffer harus lebih besar dari atau sama dengan nilai sizeof(TRACEHANDLE). |
*(PTRACEHANDLE)TraceInformation diatur ke handel pelacakan peristiwa untuk pencatat global. |
EventLoggerHandleClass | Hanya untuk penggunaan internal. | Hanya untuk penggunaan internal. |
AllLoggerHandlesClass |
traceInformationLength diatur ke ukuran, byte, dari array nilai m TRACEHANDLE.
Ukurannya, dalam byte buffer TraceInformation |
Buffer |
TraceHandleByNameClass |
TraceInformationLength diatur ke nilai sizeof(TRACEHANDLE).
Ukurannya, dalam byte, dari traceInformation buffer harus lebih besar dari atau sama dengan nilai sizeof(TRACEHANDLE). (PUNICODE_STRING)Buffer menentukan nama pelacakan yang ramah dalam format Unicode. |
*(PTRACEHANDLE)TraceInformation diatur ke handel pelacakan peristiwa yang terkait dengan nama ramah yang ditentukan. |
Jika pemanggil menyediakan penunjuk null non-
WmiQueryTraceInformation berjalan di IRQL pemanggil.
Persyaratan
Syarat | Nilai |
---|---|
klien minimum yang didukung | Tersedia di Windows XP dan versi Windows yang lebih baru. |
Platform Target |
Universal |
Header |
wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h) |
Pustaka |
NtosKrnl.lib |
DLL |
NtosKrnl.exe |
IRQL | Lihat bagian Keterangan. |