IWDFIoRequest3::RetrieveActivityId 메서드(wudfddi.h)
[경고: UMDF 2는 UMDF의 최신 버전이며 UMDF 1을 대체합니다. 모든 새 UMDF 드라이버는 UMDF 2를 사용하여 작성해야 합니다. UMDF 1에는 새로운 기능이 추가되지 않으며 최신 버전의 Windows 10에서는 UMDF 1에 대한 지원이 제한되어 있습니다. 유니버설 Windows 드라이버는 UMDF 2를 사용해야 합니다. 자세한 내용은 UMDF시작 .]을 참조하세요.
RetrieveActivityId 메서드는 I/O 요청과 연결된 현재 활동 식별자를 검색합니다.
통사론
HRESULT RetrieveActivityId(
[out] LPGUID ActivityId
);
매개 변수
[out] ActivityId
검색된 GUID를 저장할 위치에 대한 포인터입니다.
반환 값
RetrieveActivityId 호출에 성공하면 S_OK 반환합니다. 그렇지 않으면 이 메서드는 다음 값 중 하나를 반환할 수 있습니다.
| 반환 코드 | 묘사 |
|---|---|
|
요청과 연결된 활동 ID가 없습니다. |
발언
커널 모드에서 반영된 요청은 커널 추적 공급자를 사용하도록 설정하거나 요청을 받은 후 IWDFIoRequest3::SetActivityId라는 UMDF 드라이버가 경우에만 활동 식별자를 사용할 수 있습니다. ETW(Windows용 이벤트 추적)에 대한 자세한 내용은 이벤트 추적참조하세요.
UMDF 드라이버에서 시작한 요청에는 이전에 IWDFIoRequest3::SetActivityId호출한 UMDF 드라이버가 있는 경우에만 활동 식별자를 사용할 수 있습니다.
드라이버가 IWdfIoRequest2::Reuse호출할 때 프레임워크는 요청의 활동 식별자를 지우지 않습니다.
활동 식별자에 대한 자세한 내용은 활동 식별자 사용참조하세요.
이 메서드에 해당하는 UMDF 2는 WdfRequestRetrieveActivityId .
예제
다음 코드 예제에서는 드라이버가 한 요청에서 활동 식별자를 검색한 다음 이를 사용하여 다른 요청에 대한 활동 식별자를 설정할 수 있습니다.
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();
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 8 |
| 지원 종료 | UMDF 2.0 이상에서는 사용할 수 없습니다. |
| 대상 플랫폼 | 바탕 화면 |
| 최소 UMDF 버전 | 1.11 |
| 헤더 | wudfddi.h(Wudfddi.h 포함) |
| DLL | WUDFx.dll |