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 code | Description |
---|---|
|
HvUnmapEventLogBuffer successfully unmapped a single event log buffer. |
|
The caller is not the root partition. |
|
The specified event log type is invalid. |
|
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 |
|
IRQL | Any level |
See also
Send comments about this topic to Microsoft
Build date: 11/16/2013