Macro TraceLoggingOptionGroup (traceloggingprovider.h)

Article
03/13/2024

Macro TraceLogging à utiliser dans TRACELOGGING_DEFINE_PROVIDER pour spécifier un groupe de fournisseurs.

La plupart des fournisseurs TraceLogging ne sont pas associés à un groupe de fournisseurs et n’ont pas besoin d’utiliser TraceLoggingOptionGroup.

Syntaxe

void TraceLoggingOptionGroup(
  [in]  g1,
  [in]  g2,
  [in]  g3,
  [in]  g4,
  [in]  g5,
  [in]  g6,
  [in]  g7,
  [in]  g8,
  [in]  g9,
  [in]  g10,
  [in]  g11
);

Paramètres

[in] g1

Quatre premiers octets du GUID.

[in] g2

Deux octets suivants du GUID.

[in] g3

Deux octets suivants du GUID.

[in] g4

Octet suivant du GUID.

[in] g5

Octet suivant du GUID.

[in] g6

Octet suivant du GUID.

[in] g7

Octet suivant du GUID.

[in] g8

Octet suivant du GUID.

[in] g9

Octet suivant du GUID.

[in] g10

Octet suivant du GUID.

[in] g11

Octet suivant du GUID.

Valeur de retour

None

Remarques

Si vous souhaitez que votre fournisseur soit associé à un groupe de fournisseurs ETW, ajoutez la macro TraceLoggingOptionGroup à la déclaration TRACELOGGING_DEFINE_PROVIDER pour spécifier le GUID de groupe du fournisseur.

Un fournisseur ne peut pas être membre de plusieurs groupes. La sémantique de l’appartenance au groupe est déterminée par les contrôleurs ETW qui s’abonnent à un groupe via EnableTraceEx2 avec EVENT_ENABLE_PROPERTY_PROVIDER_GROUP.

Exemples

TRACELOGGING_DEFINE_PROVIDER(
    g_hMyProvider,
    "MyProvider",
    // {b3864c38-4273-58c5-545b-8b3608343471}
    (0xb3864c38,0x4273,0x58c5,0x54,0x5b,0x8b,0x36,0x08,0x34,0x34,0x71),
    // {798d0c76-4209-5932-a2af-2d94a2e66c45}
    TraceLoggingOptionGroup(0x798d0c76,0x4209,0x5932,0xa2,0xaf,0x2d,0x94,0xa2,0xe6,0x6c,0x45));

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau \| applications UWP]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau \| applications UWP]
Plateforme cible	Windows
En-tête	traceloggingprovider.h