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 반환합니다. 그렇지 않으면 이 메서드는 다음 값 중 하나를 반환할 수 있습니다.

설명

커널 모드에서 반영된 요청은 커널 추적 공급자를 사용하도록 설정하거나 요청을 받은 후 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();

요구 사항

추가 정보

IWDFIoRequest3

IWDFIoRequest3::SetActivityId