Edit

DXGKDDICB_PARTITIONING_EVENT_NOTIFICATION structure (d3dkmddi.h)

  • Article

DXGKDDICB_PARTITIONING_EVENT_NOTIFICATION is the structure used by the DxgkCbLogEtwEvent callback to log an event when its EventGuid parameter is GUID_DXGKDDI_AZURE_TRIAGE_EVENT.

Syntax

typedef struct _DXGKDDICB_PARTITIONING_EVENT_NOTIFICATION {
  HANDLE                          hAdapter;
  DXGIDDI_PARTITIONING_EVENT_TYPE EventType;
  ULONG                           PartitionId;
  WCHAR                           EventDescription[DXGKDDI_PARTITION_EVENT_DESCRIPTION_MAX];
  UINT64                          EventData1;
  UINT64                          EventData2;
  UINT64                          EventData3;
  UINT64                          EventData4;
  UINT64                          EventData5;
} DXGKDDICB_PARTITIONING_EVENT_NOTIFICATION, *PDXGKDDICB_PARTITIONING_EVENT_NOTIFICATION;

Members

hAdapter

The adapter handle used by the driver to identify the instance reporting the event.

EventType

a DXGIDDI_PARTITIONING_EVENT_TYPE value that identifies the type of event being reported.

PartitionId

The notification structure is the same as used elsewhere in the GPU Partitioning DDI (for example, DXGKDDI_CREATEVIRTUALGPU) and is a number in 0 to (Partitions - 1) when the event refers to something occurring to a virtual function. If the event refers to something occurring in the context of the physical function, it should report ULONG_MAX - 1. To identify events that occur across the entire GPU, it should report ULONG_MAX.

EventDescription[DXGKDDI_PARTITION_EVENT_DESCRIPTION_MAX]

A useful, descriptive string for the driver to identify the meaning of the event. The driver can also use the EventDataN members as additional string information if this is useful.

EventData1

An optional first parameter that contains additional useful data that may help triage the event.

EventData2

An optional second parameter that contains additional useful data that may help triage the event.

EventData3

An optional third parameter that contains additional useful data that may help triage the event.

EventData4

An optional fourth parameter that contains additional useful data that may help triage the event.

EventData5

An optional fifth parameter that contains additional useful data that may help triage the event.

Remarks

See DxgkCbLogEtwEvent for additional details.

Requirements

Requirement Value
Minimum supported server Windows Server 2022
Header d3dkmddi.h

See also

DxgkCbLogEtwEvent

DXGIDDI_PARTITIONING_EVENT_TYPE