KsSetTargetDeviceObject 함수(ks.h)

아티클
03/01/2024

KsSetTargetDeviceObject 함수는 개체의 대상 디바이스 개체를 설정합니다. 함수는 대상 디바이스가 있는 개체 헤더 목록에 개체 헤더를 추가합니다.

구문

KSDDKAPI VOID KsSetTargetDeviceObject(
  [in]           KSOBJECT_HEADER Header,
  [in, optional] PDEVICE_OBJECT  TargetDevice
);

매개 변수

[in] Header

KsAllocateObjectHeader에서 이전에 할당한 헤더를 가리킵니다.

[in, optional] TargetDevice

필요에 따라 기본 디바이스 개체의 스택 깊이를 다시 계산할 때 사용할 대상 디바이스 개체를 포함합니다. 값이 NULL이면 현재 설정이 제거됩니다. 값이 NULL 이외의 설정이면 현재 설정이 바뀝니다.

반환 값

없음

설명

KsSetTargetDeviceObject 함수는 호출자가 이전에 KsAllocateDeviceHeader 함수를 사용하여 기본 디바이스 개체에 디바이스 헤더를 할당한 것으로 가정합니다. 디바이스 헤더가 있으면 나중에 KsRecalculateStackDepth 함수를 호출할 수 있으며, 개체가 다른 디바이스에 대한 연결을 통해 IRP를 전달하고 스택 깊이를 추적해야 할 때 디바이스 헤더가 사용됩니다.

KsSetDevicePnpAndBaseObject를 사용하여 PnP 개체 스택을 할당하는 경우 스택 깊이를 다시 계산할 때 해당 디바이스 개체도 고려됩니다.