WdfRequestSetActivityId-Funktion (wdfrequest.h)

[Gilt nur für UMDF]

Die WdfRequestSetActivityId Methode ordnet eine Aktivitäts-ID einer E/A-Anforderung zu.

Syntax

VOID WdfRequestSetActivityId(
  [in] WDFREQUEST Request,
  [in] LPGUID     ActivityId
);

Parameter

[in] Request

Ein Handle zu einem Framework-Anforderungsobjekt.

[in] ActivityId

Ein Zeiger auf die GUID der Aktivitäts-ID, die in der E/A-Anforderung gespeichert werden soll.

Rückgabewert

Nichts

Bemerkungen

Durch Aufrufen WdfRequestSetActivityId wird keine Zuordnung mit einem zuvor vorhandenen Aktivitätsbezeichner festgelegt. Wenn der Treiber WdfRequestSetActivityIdaufruft, wird jeder vorhandene Aktivitätsbezeichner überschrieben.

Rufen Sie zum Festlegen einer Zuordnung den vorhandenen Bezeichner ab, indem Sie WdfRequestRetrieveActivityId aufrufen und dann den vorhandenen Bezeichner dem neuen bezeichner zuordnen, indem Sie EventWriteTransferaufrufen.

Das Framework löscht den Aktivitätsbezeichner einer Anforderung nicht, wenn der Treiber WdfRequestReuseaufruft.

Weitere Informationen zu Aktivitätsbezeichnern finden Sie unter Verwenden von Aktivitätsbezeichnern.

Anforderungen

Siehe auch

WdfRequestRetrieveActivityId