HvDeleteEventLogBuffer function

The HvDeleteEventLogBuffer function deallocates a single event log buffer for the specified event log buffer group.

Syntax


HV_STATUS  HvDeleteEventLogBuffer(
  _In_  HV_EVENTLOG_TYPE Type,
  _In_  HV_EVENTLOG_BUFFER_INDEX BufferIndex
);

Parameters

Type [in]: An HV_EVENTLOG_TYPE value that specifies the type of the event log buffer group of which the buffer to delete is a member.
BufferIndex [in]: An HV_EVENTLOG_BUFFER_INDEX value that specifies the buffer index number that is associated with the buffer to be deleted.

Return value

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

Return code	Description
HV_STATUS_SUCCESS	HvDeleteEventLogBuffer successfully deallocated a single event log buffer.
HV_STATUS_ACCESS_DENIED	The caller is not the root partition.
HV_STATUS_INVALID_PARAMETER	One of the following invalid parameter conditions exists: The specified event log type is invalid. A buffer with the specified index does not exist.
HV_STATUS_OPERATION_DENIED	One of the following conditions exists: The event log buffer group that is associated with this type has not been initialized. The event log buffer that is associated with the specified index and type has not been unmapped.

Remarks

The buffer that HvDeleteEventLogBuffer deallocates must not be mapped. The pages that constitute the buffer are returned to the partition's pool from which they came.

HvDeleteEventLogBuffer has the following restrictions:

The caller must be the root partition.

Native Interface

HvDeleteEventLogBuffer [fast]
	Call Code = 0x0063
Input Parameters
0	Type (4 bytes) BufferIndex (4 bytes)

Requirements