Funzione WdfRequestRetrieveActivityId (wdfrequest.h)

  • Articolo

[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 per 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.

Commenti

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 denominato WdfRequestSetActivityId dopo aver ricevuto la richiesta. Per altre informazioni su Traccia eventi per Windows (ETW), vedere Traccia eventi.

Le richieste avviate dal driver UMDF hanno un identificatore di attività disponibile solo se il driver UMDF in precedenza denominato 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 Uso degli identificatori di attività.

Requisiti

Requisito Valore
Client minimo supportato Windows 8.1
Piattaforma di destinazione Universale
Versione UMDF minima 2,0
Intestazione wdfrequest.h (include Wdf.h)
Libreria WUDFx02000.lib
DLL WUDFx02000.dll
IRQL PASSIVE_LEVEL

Vedi anche

WdfRequestSetActivityId