EtwSetInformation-Funktion (wdm.h)
Die EtwSetInformation bietet spezielle Informationen zum Ändern einer Kernelmodus-ETW-Anbieterregistrierung. Die EtwSetInformation Funktion ist das Kernelmodusäquivalent der EventSetInformation-funktion.
Syntax
NTSTATUS EtwSetInformation(
[in] REGHANDLE RegHandle,
[in] EVENT_INFO_CLASS InformationClass,
[in, optional] PVOID EventInformation,
[in] ULONG InformationLength
);
Parameter
[in] RegHandle
Das Registrierungshandle des ETW-Anbieters, der geändert werden soll. Der Registrierungshandle wird von EtwRegisterzurückgegeben.
[in] InformationClass
Der Typ (EVENT_INFO_CLASS) des Vorgangs, der für das Registrierungsobjekt ausgeführt werden soll.
[in, optional] EventInformation
Der Eingabepuffer.
[in] InformationLength
Größe des Eingabepuffers.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird der Rückgabewert STATUS_SUCCESS.
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_INVALID_HANDLE | Dieser Fehler wird zurückgegeben, wenn der RegHandle Parameter kein gültiges Registrierungshandle ist. |
| STATUS_INVALID_PARAMETER | Mindestens ein Parameter ist ungültig. |
| STATUS_INVALID_DEVICE_REQUEST | Die Anforderung wird nicht unterstützt. |
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows 10 und höheren Versionen von Windows. |
| Zielplattform- | Universal |
| Header- | wdm.h (include Wdm.h) |
| Library | NtosKrnl.lib |
| IRQL- | PASSIVE_LEVEL |