Funzione WdfRequestRetrieveActivityId (wdfrequest.h)

Articolo
02/07/2025

[Si applica solo a UMDF]

Il metodo WdfRequestRetrieveActivityId recupera l'identificatore di attività corrente associato a una richiesta di I/O.

Sintassi

NTSTATUS WdfRequestRetrieveActivityId(
  [in]  WDFREQUEST Request,
  [out] LPGUID     ActivityId
);

Parametri

[in] Request

Handle per un oggetto richiesta framework.

[out] ActivityId

Puntatore a una posizione in cui archiviare il GUID recuperato.

Valore restituito

Se l'operazione ha esito positivo, WdfRequestRetrieveActivityId restituisce STATUS_SUCCESS. I valori restituiti aggiuntivi includono:

Codice restituito	Descrizione
STATUS_NOT_FOUND	Nessun ID attività è associato alla richiesta.

Il metodo potrebbe restituire altri valori NTSTATUS .

Osservazioni

Le richieste riflesse dalla modalità kernel hanno un identificatore di attività disponibile solo se il provider di traccia del kernel è abilitato o se il driver UMDF chiamato WdfRequestSetActivityId dopo aver ricevuto la richiesta. Per altre informazioni su Event Tracing for Windows (ETW), vedere Event Tracing.

Le richieste avviate dal driver UMDF hanno un identificatore di attività disponibile solo se il driver UMDF precedentemente chiamato WdfRequestSetActivityId.

Il framework non cancella l'identificatore dell'attività di una richiesta quando il driver chiama WdfRequestReuse.

Per altre informazioni sugli identificatori di attività, vedere Using Activity Identifiers.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 8.1
piattaforma di destinazione	Universale
versione minima di UMDF	2.0
intestazione	wdfrequest.h (include Wdf.h)
libreria	WUDFx02000.lib
dll	WUDFx02000.dll
IRQL	PASSIVE_LEVEL

Vedere anche

WdfRequestSetActivityId

Condividi tramite