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. Nessuna nuova funzionalità viene aggiunta 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, vedere Introduzione con 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 di 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 associando l'identificatore esistente al nuovo chiamando EventWriteTransfer.
Il framework non cancella l'identificatore dell'attività di una richiesta quando il driver chiama IWdfIoRequest2::Rius.
Per altre informazioni sugli identificatori di attività, vedere Uso degli identificatori di attività.
L'equivalente UMDF 2 di questo metodo è WdfRequestSetActivityId.
Esempio
Per un esempio di codice che usa SetActivityId, vedere RetrieveActivityId.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 8 |
| Fine del supporto | Non disponibile in UMDF 2.0 e versioni successive. |
| Piattaforma di destinazione | Desktop |
| Versione UMDF minima | 1.11 |
| Intestazione | wudfddi.h (include Wudfddi.h) |
| DLL | WUDFx.dll |