EventDataDescCreate-Funktion (evntprov.h)

2023-08-23

Legt die Werte eines EVENT_DATA_DESCRIPTOR fest.

Syntax

EVNTPROV_PFORCEINLINE VOID EventDataDescCreate(
  [out] PEVENT_DATA_DESCRIPTOR EventDataDescriptor,
  [in]  const VOID             *DataPtr,
  [in]  ULONG                  DataSize
);

Parameter

[out] EventDataDescriptor

Der Datendeskriptor, dessen Memberwerte auf die der verbleibenden Parameter festgelegt sind. Ausführliche Informationen finden Sie unter EVENT_DATA_DESCRIPTOR.

[in] DataPtr

Ein Zeiger auf die Ereignisdaten. Dieser Wert wird verwendet, um das Ptr-Element des Deskriptors festzulegen.

Der DataPtr-Parameter kann nur NULL sein, wenn DataSize 0 ist.

[in] DataSize

Die Größe (in Bytes) der Ereignisdaten. Der Wert wird verwendet, um das Size-Element des Deskriptors festzulegen.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Bemerkungen

Dies ist ein Komfortmakro zum Festlegen der Elemente der EVENT_DATA_DESCRIPTOR-Struktur . Wenn Sie die Member selbst initialisieren, ohne EventDataDescCreate aufzurufen, sollten Sie festlegen Ptr = (UINT_PTR)DataPtr, und Sie müssen das Feld Reserviert initialisieren (z. B. auf 0 festlegen).

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	evntprov.h