Bagikan melalui


Fungsi WmiQueryTraceInformation (wdm.h)

Rutinitas WmiQueryTraceInformation mengembalikan informasi tentang jejak peristiwa WMI .

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 RequiredLength ke NULL jika tidak menggunakan informasi panjang yang diperlukan.

[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
STATUS_SUCCESS
Keberhasilan
STATUS_INFO_LENGTH_MISMATCH
Ukuran buffer TraceInformation tidak sama dengan ukuran yang diperlukan untuk informasi pelacakan peristiwa yang ditentukan.
STATUS_INVALID_HANDLE
Handel pelacakan yang ditentukan oleh anggota HistoricalContext dari PWNODE_HEADERbuffer tidak valid.
STATUS_INVALID_INFO_CLASS
Tipe informasi pelacakan peristiwa yang ditentukan tidak valid.
STATUS_INVALID_PARAMETER
Nama pelacakan peristiwa, yang disediakan dengan kueri untuk mengembalikan handel pelacakan yang diberikan namanya, tidak valid.
STATUS_INVALID_PARAMETER_MIX
Pemanggil tidak menyediakan informasi yang diperlukan untuk informasi pelacakan peristiwa yang ditentukan.
STATUS_MORE_ENTRIES
Buffer TraceInformation tidak cukup besar untuk menyimpan array dari semua handel pelacakan peristiwa yang valid.
STATUS_NOT_FOUND
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 TraceClassInformation Persyaratan input Informasi yang dikembalikan
TraceIdClass 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 TraceInformationLength lebih besar dari atau sama dengan nilaiukuran (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 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 harus lebih besar dari atau sama dengan nilai (mukuran(TRACEHANDLE)).

Buffer TraceInformation berisi array handel jejak n, di mana n adalah minimum m, jumlah handel pelacakan peristiwa yang disediakan penelepon, dan jumlah handel pelacakan peristiwa yang valid. Rutinitas mengembalikan status STATUS_MORE_ENTRIES jika buffer TraceInformation terlalu kecil untuk menahan semua handel jejak.
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-NULLRequiredLength, WmiQueryTraceInformation juga mengembalikan panjang yang diperlukan untuk informasi pelacakan peristiwa yang ditentukan.

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.

Lihat juga

IoWmiWriteEvent

TRACE_INFORMATION_CLASS

WmiFireEvent

WmiTraceMessage

WmiTraceMessageVa