HvSetEventLogGroupSources function

The HvSetEventLogGroupSources function enables or disables specific event sources that are associated with the specific event log type.

Syntax


HV_STATUS  HvSetEventLogGroupSources(
  _In_  HV_EVENTLOG_TYPE Type,
  _In_  UINT64 EnableFlags
);

Parameters

Type [in]

An HV_EVENTLOG_TYPE value that specifies the type of the event log buffer group for which event sources are enabled or disabled.

EnableFlags [in]

A 64-bitmask that specifies the event sources to enable. The meaning of each bit in the mask depends on the event log type. For tracing to start, this mask must be nonzero; that is, at least one event source must be enabled.

Return value

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

Return codeDescription
HV_STATUS_SUCCESS

HvSetEventLogGroupSources successfully enabled or disabled specific event sources.

HV_STATUS_ACCESS_DENIED

The caller is not the root partition.

HV_STATUS_INVALID_PARAMETER

The specified event log type is invalid.

HV_STATUS_OPERATION_DENIED

The event log buffer group is not initialized.

 

Remarks

HvSetEventLogGroupSources allows the guest to enable or disable a set of up to 64 event sources. When the EnableFlags parameter is set to zero, event logging is disabled.

HvSetEventLogGroupSources has the following restrictions:

  • The caller must be the root partition.

Native Interface

HvSetEventLogGroupSources [fast]

Call Code = 0x0066

Input Parameters

0

Type (4 bytes) Padding (4 bytes)

8

EnableFlags (8 bytes)

 

Requirements

Version

HvSetEventLogGroupSources 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.