WdfRequestSetActivityId-Funktion (wdfrequest.h)

[Gilt nur für UMDF]

Die WdfRequestSetActivityId-Methode ordnet einer E/A-Anforderung einen Aktivitätsbezeichner zu.

Syntax

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

Parameter

[in] Request

Ein Handle für ein Frameworkanforderungsobjekt.

[in] ActivityId

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

Rückgabewert

Keine

Bemerkungen

Durch aufrufen von WdfRequestSetActivityId wird keine Zuordnung zu einem zuvor vorhandenen Aktivitätsbezeichner festgelegt. Wenn der Treiber WdfRequestSetActivityId aufruft, wird jeder vorhandene Aktivitätsbezeichner überschrieben.

Um eine Zuordnung festzulegen, rufen Sie den vorhandenen Bezeichner durch Aufrufen von WdfRequestRetrieveActivityId ab, und ordnen Sie dann den vorhandenen Bezeichner dem neuen zu, indem Sie EventWriteTransfer aufrufen.

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

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

Anforderungen

Weitere Informationen

WdfRequestRetrieveActivityId