HvUnmapEventLogBuffer function

The HvUnmapEventLogBuffer function unmaps an event log buffer.

Syntax


HV_STATUS  HvUnmapEventLogBuffer(
  _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 whose buffer is unmapped.

BufferIndex [in]

An HV_EVENTLOG_BUFFER_INDEX value that specifies the index of the buffer within the buffer group that is associated with the event log type that the Type parameter specifies.

Return value

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

Return codeDescription
HV_STATUS_SUCCESS

HvUnmapEventLogBuffer successfully unmapped a single event log buffer.

HV_STATUS_ACCESS_DENIED

The caller is not the root partition.

HV_STATUS_INVALID_PARAMETER

The specified event log type is invalid.

HV_STATUS_ACCESS_DENIED

The event log buffer is not in the free or ready state.

 

Remarks

HvUnmapEventLogBuffer revokes the read-only mappings of the pages that constitute the specified buffer.

Buffers can be unmapped only if they are in the free or ready state. Buffers that are successfully unmapped are no longer available for the hypervisor to use for event logging.

HvUnmapEventLogBuffer has the following restrictions:

  • The caller must be the root partition.

Native Interface

HvUnmapEventLogBuffer [fast]

Call Code = 0x0065

Input Parameters

0

Type (4 bytes) BufferIndex (4 bytes)

 

Requirements

Version

HvUnmapEventLogBuffer is available in version 1.0 and later versions of the hypervisor.

Header

Hvgdk.h (include Hvgdk.h)

IRQL

Any level

See also

HV_EVENTLOG_TYPE

 

 

Send comments about this topic to Microsoft

Build date: 11/16/2013

Show:
© 2014 Microsoft. All rights reserved.