IoSetActivityIdIrp 함수(ntddk.h)

IoSetActivityIdIrp 루틴은 활동 ID를 IRP와 연결합니다.

구문

NTSTATUS IoSetActivityIdIrp(
  [in]           PIRP    Irp,
  [in, optional] LPCGUID Guid
);

[in] Irp

활동 ID를 연결할 IRP입니다.

[in, optional] Guid

IRP에 저장할 ID를 나타내는 GUID에 대한 포인터입니다. NULL인 경우 IoSetActivityIdIrp은 원래 요청을 발급한 스레드인 경우 현재 스레드에서 활동 ID를 검색하려고 시도합니다.

IoSetActivityIdIrp은 호출에 성공하면 STATUS_SUCCESS 반환합니다. 가능한 오류 반환 값은 다음과 같습니다.

반환 코드	설명
STATUS_NOT_SUPPORTED	GUID가 제공되지 않았고 ETW 활동 ID를 사용할 수 없습니다.
STATUS_UNSUCCESSFUL	IRP에서 I/O 추적 공급자를 사용하도록 설정하지 않았습니다.

드라이버는 IoAllocateIrp를 사용하여 할당되고 IoFreeIrp 를 사용하여 해제된 IRP에서만 IoSetActivityIdIrp를 사용해야 합니다. 그렇지 않으면 메모리 누수로 인해 발생할 수 있습니다.

요구 사항	값
지원되는 최소 클라이언트	Windows 8 사용하여 사용할 수 있습니다.
대상 플랫폼	유니버설
헤더	ntddk.h(Ntddk.h 포함)
라이브러리	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	GUID가 전달되면 모든 수준이며, 그렇지 않으면 PASSIVE_LEVEL.