IWDFIoRequest3::SetActivityId 메서드(wudfddi.h)

[경고: UMDF 2는 UMDF의 최신 버전이며 UMDF 1을 대체합니다. 모든 새 UMDF 드라이버는 UMDF 2를 사용하여 작성해야 합니다. UMDF 1에 새 기능이 추가되지 않으며 최신 버전의 Windows 10 UMDF 1에 대한 지원이 제한되어 있습니다. 유니버설 Windows 드라이버는 UMDF 2를 사용해야 합니다. 자세한 내용은 UMDF를 사용하여 시작 참조하세요.]

SetActivityId 메서드는 활동 식별자를 I/O 요청에 연결합니다.

구문

void SetActivityId(
  [in] LPGUID ActivityId
);

매개 변수

[in] ActivityId

I/O 요청에 저장할 활동 식별자 GUID에 대한 포인터입니다.

반환 값

없음

설명

SetActivityId를 호출해도 이전에 제공된 활동 식별자와의 연결이 설정되지 않습니다. 드라이버가 SetActivityId를 호출하면 기존 활동 식별자를 덮어씁니다.

연결을 설정하려면 RetrieveActivityId 를 호출하여 기존 식별자를 검색한 다음 EventWriteTransfer를 호출하여 기존 식별자를 새 식별자와 연결합니다.

프레임워크는 드라이버가 IWdfIoRequest2::Reuse를 호출할 때 요청의 활동 식별자를 지우지 않습니다.

활동 식별자에 대한 자세한 내용은 활동 식별자 사용을 참조하세요.

이 메서드에 해당하는 UMDF 2는 WdfRequestSetActivityId입니다.

예제

SetActivityId를 사용하는 코드 예제는 RetrieveActivityId를 참조하세요.

요구 사항

추가 정보

IWDFIoRequest3

IWDFIoRequest3::RetrieveActivityId

WdfRequestSetActivityId