Expand Minimize

HV_EVENTLOG_MESSAGE_PAYLOAD structure

The HV_EVENTLOG_MESSAGE_PAYLOAD structure describes a trace-payload message.

Syntax


typedef struct _HV_EVENTLOG_MESSAGE_PAYLOAD {
  HV_EVENTLOG_TYPE         EventLogType;
  HV_EVENTLOG_BUFFER_INDEX BufferIndex;
} HV_EVENTLOG_MESSAGE_PAYLOAD, *PHV_EVENTLOG_MESSAGE_PAYLOAD;

Members

EventLogType

A HV_EVENTLOG_TYPE value that specifies the type of the trace buffer that has been placed into a complete state.

BufferIndex

The index of the first buffer in a ready-buffer list. The NextBufferIndex member of the event log buffer header (in the message payload) will contain the index of the next buffer in the list. The end of the list is indicated by a buffer index that matches the value HV_EVENTLOG_BUFFER_INDEX_NONE. Buffers appear in the list in the order in which they were placed into the complete state. If the event log buffer type uses buffers of the local buffer class, the list contains only buffers that were completed by this logical processor.

Remarks

Trace-payload messages are sent to the root partition when one of the following events occur:

  • The number of pending ready event log buffers reaches the threshold that is established by the guest by using the HvInitializeEventLogBufferGroup hypercall.

  • The guest has requested that all pending complete and in-use event log buffers be flushed.

The HV_EVENTLOG_MESSAGE_PAYLOAD structure is used in the HV_MESSAGE structure.

Requirements

Header

HvTrApi.h (include Hvgdk.h)

See also

HV_EVENTLOG_TYPE
HV_MESSAGE
HvInitializeEventLogBufferGroup

 

 

Send comments about this topic to Microsoft

Build date: 11/16/2013

Show:
© 2014 Microsoft. All rights reserved.