Metodo IWDFIoRequest3::SetActivityId (wudfddi.h)
[Avviso: UMDF 2 è la versione più recente di UMDF e sostituisce UMDF 1. Tutti i nuovi driver UMDF devono essere scritti usando UMDF 2. Non vengono aggiunte nuove funzionalità a UMDF 1 ed è disponibile un supporto limitato per UMDF 1 nelle versioni più recenti di Windows 10. I driver di Windows universali devono usare UMDF 2. Per altre informazioni, vedi Introduzione a UMDF.]
Il metodo SetActivityId associa un identificatore di attività a una richiesta di I/O.
Sintassi
void SetActivityId(
[in] LPGUID ActivityId
);
Parametri
[in] ActivityId
Puntatore al GUID dell'identificatore di attività da archiviare nella richiesta di I/O.
Valore restituito
Nessuno
Osservazioni
La chiamata SetActivityId non imposta un'associazione con alcun identificatore di attività presente in precedenza. Quando il driver chiama SetActivityId, qualsiasi identificatore di attività esistente viene sovrascritto.
Per impostare un'associazione, recuperare l'identificatore esistente chiamando RetrieveActivityId e quindi associare l'identificatore esistente a quello nuovo chiamando EventWriteTransfer.
Il framework non cancella l'identificatore di attività di una richiesta quando il driver chiama IWdfIoRequest2::Reuse.
Per altre informazioni sugli identificatori di attività, vedere Using Activity Identifiers.
L'equivalente di UMDF 2 di questo metodo è WdfRequestSetActivityId.
Esempi
Per un esempio di codice che usa SetActivityId, vedere RetrieveActivityId.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows 8 |
| Fine del supporto | Non disponibile in UMDF 2.0 e versioni successive. |
| piattaforma di destinazione | Desktop |
| versione minima di UMDF | 1.11 |
| intestazione | wudfddi.h (include Wudfddi.h) |
| dll | WUDFx.dll |