HvFinalizeEventLogBufferGroup function

The HvFinalizeEventLogBufferGroup function destroys the event log buffer group that is associated with a specific event log type.

Syntax

C++


HV_STATUS  HvFinalizeEventLogBufferGroup(
  _In_  HV_EVENTLOG_TYPE Type
);

Parameters

Type [in]: An HV_EVENTLOG_TYPE value that specifies the type of the associated group to finalize.

Return value

HvFinalizeEventLogBufferGroup returns one of the following values. In addition to these values, HvFinalizeEventLogBufferGroup can also return one of the values that are specified in Common Hypercall Status Codes.

Return code	Description
HV_STATUS_SUCCESS	HvFinalizeEventLogBufferGroup successfully finalized the event log buffer group.
HV_STATUS_ACCESS_DENIED	The caller is not the root partition.
HV_STATUS_INVALID_PARAMETER	The specified event log type is invalid.
HV_STATUS_OPERATION_DENIED	One of the following conditions exists: There is at least one buffer that remains in the event log group that is associated with the specified event log type. The specified event log type has not been initialized. All sources for the specified event log type are not disabled.

Remarks

HvFinalizeEventLogBufferGroup destroys the event log buffer group and returns all allocated resources for the group's infrastructure to the partition's pool. The group should contain no buffers (that is, all buffers should have been unmapped and deleted) when HvFinalizeEventLogBufferGroup is called or HvFinalizeEventLogBufferGroup returns HV_STATUS_OPERATION_DENIED.

HvFinalizeEventLogBufferGroup has the following restrictions:

The caller must be the root partition.

Native Interface

HvFinalizeEventLogBufferGroup [fast]
	Call Code = 0x0061
Input Parameters
0	Type (4 bytes) Padding (4 bytes)

Requirements