Metodo IWDFIoRequest3::RetrieveActivityId (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 RetrieveActivityId recupera l'identificatore di attività corrente associato a una richiesta di I/O.
Sintassi
HRESULT RetrieveActivityId(
[out] LPGUID ActivityId
);
Parametri
[out] ActivityId
Puntatore a una posizione per archiviare il GUID recuperato.
Valore restituito
RetrieveActivityId restituisce S_OK se la chiamata ha esito positivo. In caso contrario, questo metodo potrebbe restituire uno dei valori seguenti.
Codice restituito | Descrizione |
---|---|
|
Nessun ID attività è associato alla richiesta. |
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 IWDFIoRequest3::SetActivityId 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 precedentemente denominato IWDFIoRequest3::SetActivityId.
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 è WdfRequestRetrieveActivityId.
Esempio
Nell'esempio di codice seguente viene illustrato che un driver può recuperare un identificatore di attività da una richiesta e quindi usarlo per impostare l'identificatore dell'attività per un'altra richiesta.
hrQI = pWdfRequest->QueryInterface(IID_PPV_ARGS(&pOriginalRequest3));
ASSERT(SUCCEEDED(hrQI));
hrQI = pNewRequest->QueryInterface(IID_PPV_ARGS(&pNewRequest3));
ASSERT(SUCCEEDED(hrQI));
//
// Obtain activity id from original request and set in the new one
//
pOriginalRequest3->RetrieveActivityId(&activityId);
pNewRequest3->SetActivityId(&activityId);
pOriginalRequest3->Release();
pNewRequest3->Release();
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 |
Vedi anche
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per