WdfRequestRetrieveActivityId 함수(wdfrequest.h)

[UMDF에만 적용]

WdfRequestRetrieveActivityId 메서드는 I/O 요청과 연결된 현재 활동 식별자를 검색합니다.

구문

NTSTATUS WdfRequestRetrieveActivityId(
  [in]  WDFREQUEST Request,
  [out] LPGUID     ActivityId
);

매개 변수

[in] Request

프레임워크 요청 개체에 대한 핸들입니다.

[out] ActivityId

검색된 GUID를 저장할 위치에 대한 포인터입니다.

반환 값

작업이 성공하면 WdfRequestRetrieveActivityId는 STATUS_SUCCESS 반환합니다. 추가 반환 값은 다음과 같습니다.

메서드는 다른 NTSTATUS 값을 반환할 수 있습니다.

설명

커널 모드에서 반영된 요청은 커널 추적 공급자를 사용하도록 설정하거나 요청을 받은 후 WdfRequestSetActivityId 라는 UMDF 드라이버가 있는 경우에만 활동 식별자를 사용할 수 있습니다. ETW(Windows용 이벤트 추적)에 대한 자세한 내용은 이벤트 추적을 참조하세요.

UMDF 드라이버에서 시작한 요청에는 이전에 WdfRequestSetActivityId라는 UMDF 드라이버가 있는 경우에만 활동 식별자를 사용할 수 있습니다.

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

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

요구 사항

추가 정보

WdfRequestSetActivityId