HvFlushEventLogBuffer function

The HvFlushEventLogBuffer function forces an in-use event buffer to be marked as complete and an event-log-buffers-ready notification to be queued.

Syntax

C++


HV_STATUS  HvFlushEventLogBuffer(
  _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 for which buffers are flushed.
BufferIndex [in]: The index of the buffer within the event log type.

Return value

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

Return code	Description
HV_STATUS_SUCCESS	HvFlushEventLogBuffer successfully flushed event log buffers.
HV_STATUS_ACCESS_DENIED	The caller is not the root partition.
HV_STATUS_INVALID_PARAMETER	The specified event log type is invalid or the specified index for an event log buffer of this type is invalid.
HV_STATUS_OPERATION_DENIED	The event log buffer group has not been initialized.

Remarks

HvFlushEventLogBuffer places an in-use event buffer into the complete state, as if the event buffer had filled up through event logging activity. A caller can use HvFlushEventLogBuffer to reclaim a buffer that is partially filled. HvFlushEventLogBuffer also queues an event-log-buffers-ready notification message to a virtual processor (VP) within the root partition. This operation occurs even if the event-buffer threshold has not yet been reached. HvFlushEventLogBuffer has the following restrictions:

The caller must be the root partition.

Native Interface

HvFlushEventLogBuffer [fast]
	Call Code = 0x0068
Input Parameters
0	Type (4 bytes) BufferIndex (4 bytes)

Requirements