EtwActivityIdControl 함수(wdm.h)

EtwActivityIdControl 함수는 현재 활동 식별자를 만들고, 쿼리하고, 설정합니다.

구문

NTSTATUS EtwActivityIdControl(
  [in]      ULONG  ControlCode,
  [in, out] LPGUID ActivityId
);

[in] ControlCode

ControlCode 매개 변수는 정의된 다음 값 중 하나일 수 있습니다.

값	의미
EVENT_ACTIVITY_CTRL_GET_ID	ActivityId 매개 변수에서 현재 스레드의 활동 식별자를 반환합니다.
EVENT_ACTIVITY_CTRL_SET_ID	현재 스레드의 활동 식별자를 ActivityId에 지정된 값으로 설정합니다. 이 함수에 전달하는 ActivityId 가 반드시 EVENT_ACTIVITY_CTRL_CREATE_ID또는 EVENT_ACTIVITY_CTRL_CREATE_SET_ID 제어 코드로 만들어질 필요는 없습니다. 일부 유형의 활동 식별자에 대한 요구 사항을 충족하는 사용 가능한 로컬 값을 포함하여 GUID 내에 맞는 모든 값을 사용할 수 있습니다.
EVENT_ACTIVITY_CTRL_CREATE_ID	새 식별자를 만들고 ActivityId 매개 변수를 새 식별자의 값으로 설정합니다.
EVENT_ACTIVITY_CTRL_GET_SET_ID	현재 스레드의 활동 식별자를 ActivityId에 지정된 값으로 설정한 다음 함수 호출 전에 스레드의 활동 식별자 값으로 ActivityId 를 반환합니다.
EVENT_ACTIVITY_CTRL_CREATE_SET_ID	현재 스레드의 활동 식별자를 복사합니다. 새 식별자를 만들고 현재 스레드의 활동 식별자를 새 값으로 설정합니다. 함수 호출 전에 스레드의 활동 식별자 값이 있는 ActivityId 를 반환합니다.

[in, out] ActivityId

이벤트와 연결된 활동을 나타내는 식별자입니다. ActivityId 매개 변수는 관련 이벤트를 그룹화할 수 있는 방법을 제공하며 엔드 투 엔드 추적에 사용됩니다.

EtwActivityIdControl 은 STATUS_SUCCESS 또는 적절한 NTSTATUS 값을 반환합니다.

활동 식별자는 공통 계산 스레드에서 별도의 이벤트를 연결하는 방법을 제공합니다. 작업은 애플리케이션 및 드라이버에서 수행하는 작업 항목입니다. 활동의 개념은 엔드 투 엔드 추적의 핵심 구성 요소입니다.

ControlCode가 EVENT_ACTIVITY_CTRL_CREATE_ID 않는 한 EtwActivityIdControl의 호출자는 IRQL <DISPATCH_LEVEL 실행되어야 합니다. 이 경우 모든 IRQL에서 함수를 호출할 수 있습니다.

EtwActivityIdControlKernel 함수를 사용하여 활동 식별자 커널 스레드를 쿼리하거나 설정합니다.