This page contains reference entries in the Events API family. Each entry includes its declaration and requirements.
Process creation
ESP_PROCESS_CREATE_CONFIG
The structure ESP_PROCESS_CREATE_CONFIG is used to configure a process create event.
Syntax
typedef struct ESP_PROCESS_CREATE_CONFIG
{
ESP_PROCESS_CONFIG ProcessConfig;
ESP_FILE_OBJECT_CONFIG FileObjectConfig;
ESP_STRING_CONFIG OriginalCommandLineConfig;
ESP_THREAD_CONFIG CreatingThreadConfig;
} ESP_PROCESS_CREATE_CONFIG;
Members
| FIELD |
DESCRIPTION |
| ProcessConfig |
Specifies configuration for the process being created. Note that the "ParentProcessConfig" field in the process config structure can be used to configure the parent process. |
| FileObjectConfig |
Specifies configuration for the process executable file. |
| OriginalCommandLineConfig |
Specifies string configuration for the original command line. |
| CreatingThreadConfig |
Specifies configuration for the creating thread. Note that the "OwningProcessConfig" field in the creating thread config structure can be used to configure the creating process. |
Requirements
| Requirement |
Value |
| Header |
esptypes.h |
See also
ESP_PROCESS_CREATE_PARAMETERS
The structure ESP_PROCESS_CREATE_PARAMETERS contains the parameters associated with a process create event notification.
Syntax
typedef struct ESP_PROCESS_CREATE_PARAMETERS
{
ESP_PROCESS_INFO Process;
ESP_FILE_OBJECT_INFO FileObject;
ESP_UNICODE_STRING OriginalCommandLine;
ESP_THREAD_INFO CreatingThread;
} ESP_PROCESS_CREATE_PARAMETERS;
Members
| FIELD |
DESCRIPTION |
| Process |
The process being created. |
| FileObject |
The file object for the process executable file. |
| OriginalCommandLine |
The command line for the process. By default, the original command line is not supplied. The client must specify to include the command line through the "OriginalCommandLineConfig" field in the structure ESP_PROCESS_CREATE_CONFIG. |
| CreatingThread |
The thread creating the new process. |
Requirements
| Requirement |
Value |
| Header |
esptypes.h |
See also
Process termination
ESP_PROCESS_TERMINATE_CONFIG
The structure ESP_PROCESS_TERMINATE_CONFIG is used to configure a process terminate event.
Syntax
typedef struct ESP_PROCESS_TERMINATE_CONFIG
{
ESP_PROCESS_CONFIG ProcessConfig;
} ESP_PROCESS_TERMINATE_CONFIG;
Members
| FIELD |
DESCRIPTION |
| ProcessConfig |
Specifies configuration for the process being terminated. |
Requirements
| Requirement |
Value |
| Header |
esptypes.h |
See also
ESP_PROCESS_TERMINATE_PARAMETERS
The structure ESP_PROCESS_TERMINATE_PARAMETERS contains the parameters associated with a process terminate event notification.
Syntax
typedef struct ESP_PROCESS_TERMINATE_PARAMETERS
{
ESP_PROCESS_INFO Process;
} ESP_PROCESS_TERMINATE_PARAMETERS;
Members
| FIELD |
DESCRIPTION |
| Process |
The process being terminated. |
Requirements
| Requirement |
Value |
| Header |
esptypes.h |
See also
Image loading
ESP_PROCESS_LOAD_IMAGE_CONFIG
The structure ESP_PROCESS_LOAD_IMAGE_CONFIG is used to configure a process load image event.
Syntax
typedef struct ESP_PROCESS_LOAD_IMAGE_CONFIG
{
ESP_PROCESS_CONFIG ProcessConfig;
ESP_FILE_OBJECT_CONFIG ImageFileConfig;
ESP_INTEGER_CONFIG ImageBaseConfig;
ESP_MEMORY_ADDRESS_BASIC_CONFIG ImageBaseBasicConfig;
ESP_PATH_CONFIG ImageBaseMappedFilePathConfig;
ESP_INTEGER_CONFIG ImageSizeConfig;
ESP_INTEGER_CONFIG PropertiesConfig;
} ESP_PROCESS_LOAD_IMAGE_CONFIG;
Members
| FIELD |
DESCRIPTION |
| ProcessConfig |
Specifies configuration for the process in which the image is being loaded. |
| ImageFileConfig |
Specifies configuration for the image file being loaded. |
| ImageBaseConfig |
Specifies configuration for the image base. |
| ImageBaseBasicConfig |
Specifies configuration for basic memory address information for the image base. |
| ImageBaseMappedFilePathConfig |
Specifies configuration for the image base mapped file path. |
| ImageSizeConfig |
Specifies configuration for the image size. |
| PropertiesConfig |
Specifies configuration for the image properties. |
Requirements
| Requirement |
Value |
| Header |
esptypes.h |
See also
ESP_PROCESS_LOAD_IMAGE_PARAMETERS
The structure ESP_PROCESS_LOAD_IMAGE_PARAMETERS contains the parameters associated with a process load image event notification.
Syntax
typedef struct ESP_PROCESS_LOAD_IMAGE_PARAMETERS
{
ESP_PROCESS_INFO Process;
ESP_FILE_OBJECT_INFO ImageFile;
UINT64 ImageBase;
_Maybenull_ const ESP_MEMORY_ADDRESS_BASIC* ImageBaseBasic;
ESP_PATH ImageBaseMappedFilePath;
UINT64 ImageSize;
UINT32 Properties;
} ESP_PROCESS_LOAD_IMAGE_PARAMETERS;
Members
| FIELD |
DESCRIPTION |
| Process |
The process for which an image is being loaded. |
| ImageFile |
The image file being loaded. |
| ImageBase |
The base address of the image. |
| ImageBaseBasic |
Basic memory address information for the base address. This field is null unless it was configured to be included through the ImageBaseBasicConfig field in the rule's associated ESP_PROCESS_LOAD_IMAGE_CONFIG structure. |
| ImageBaseMappedFilePath |
Mapped file path for the base address. This field is empty unless it was configured to be included through the ImageBaseMappedFilePathConfig field in the rule's associated ESP_PROCESS_LOAD_IMAGE_CONFIG structure. |
| ImageSize |
The virtual size in bytes of the image. |
| Properties |
Image properties. This is the equivalent of the "Properties" field in the kernel structure "IMAGE_INFO". |
Requirements
| Requirement |
Value |
| Header |
esptypes.h |
See also