IoAttachDeviceToDeviceStackSafe 함수(ntddk.h)

IoAttachDeviceToDeviceStackSafe 루틴은 호출자의 디바이스 개체를 드라이버 스택의 최상위 디바이스 개체에 연결합니다.

구문

NTSTATUS IoAttachDeviceToDeviceStackSafe(
  [in]  PDEVICE_OBJECT SourceDevice,
  [in]  PDEVICE_OBJECT TargetDevice,
  [out] PDEVICE_OBJECT *AttachedToDeviceObject
);

매개 변수

[in] SourceDevice

호출자가 만든 디바이스 개체에 대한 포인터입니다.

[in] TargetDevice

SourceDevice 개체를 연결할 스택의 디바이스 개체에 대한 포인터입니다.

[out] AttachedToDeviceObject

입력에서 이 매개 변수는 NULL 포인터를 포함해야 하는 SourceDevice-DeviceExtension-AttachedToDeviceObject>>의 주소를 지정합니다. 출력 시 이 매개 변수는 SourceDevice 가 연결된 디바이스 개체에 대한 포인터를 받습니다.

반환 값

SourceDevice가 TargetDevice 위에 성공적으로 연결되면 IoAttachDeviceToDeviceStackSafe가 STATUS_SUCCESS 반환합니다. 그렇지 않으면 STATUS_NO_SUCH_DEVICE 반환됩니다.

설명

IoAttachDeviceToDeviceStack과 마찬가지로 IoAttachDeviceToDeviceStackSafe는 동일한 IRP가 스택의 각 드라이버에 전송되도록 드라이버 간에 계층을 설정합니다. 그러나 IoAttachDeviceToDeviceStack과 달리 IoAttachDeviceToDeviceStackSafe에는 필터 드라이버가 SourceDevice 개체의 AttachedToDeviceObject 필드의 주소를 전달하는 데 사용하는 추가 매개 변수 AttachedToDeviceObject가 있습니다. IoAttachDeviceToDeviceStackSafe 는 I/O 시스템 데이터베이스 잠금을 유지하면서 이 필드를 업데이트합니다. 이 잠금을 보유하기 때문에 IoAttachDeviceToDeviceStackSafe 는 SourceDevice 개체가 AttachedToDeviceObject 필드가 업데이트되기 전에 IRP를 받은 경우 발생할 수 있는 경합 상태를 방지합니다.

파일 시스템 필터 드라이버는 IoAttachDeviceToDeviceStackSafe 를 호출하여 파일 시스템 또는 다른 필터 드라이버에 속하는 디바이스 개체(TargetDevice) 위에 자체 필터 디바이스 개체(SourceDevice)를 연결합니다. AttachedToDeviceObject로 전송된 후속 I/O 요청은 먼저 필터 드라이버에 의해 수신되며, 필터 드라이버는 이를 처리하고 IoCallDriver를 호출하여 스택의 다음 드라이버로 전달합니다.

TargetDevice에서 지정한 디바이스 개체가 현재 드라이버 스택의 맨 위에 있는 경우 SourceDevice는 TargetDevice에 직접 연결됩니다. 이 경우 TargetDevice 및 반환 된 AttachedToDeviceObject 포인터가 동일합니다.

하나 이상의 필터 디바이스 개체가 드라이버 스택의 TargetDevice 위에 이미 연결되어 있는 경우 IoAttachDeviceToDeviceStackSafe 는 SourceDevice 를 최상위 필터 디바이스 개체에 연결합니다. 후자에 대한 포인터가 AttachedToDeviceObject에 반환됩니다.

스택의 맨 위에 연결된 직후에 SourceDevice 는 드라이버 스택의 위쪽을 차지합니다. 그러나 이것이 반드시 SourceDevice 가 드라이버 스택의 맨 위에 유지된다는 것을 의미하지는 않습니다. 다른 필터는 스택의 SourceDevice 위에 자체 필터 디바이스 개체를 연결할 수 있습니다.

IoAttachDeviceToDeviceStackSafe는 SourceDevice가 가리키는 디바이스 개체의 AlignmentRequirement 멤버를 다음 하위 디바이스 개체의 해당 값으로 설정하고 SourceDevice의 StackSize를 다음 하위 개체의 값과 1을 더한 값으로 설정합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	이 루틴은 Windows 2000 SP4(서비스 팩 4) 업데이트 롤업 및 Windows XP 이상에서 사용할 수 있습니다.
대상 플랫폼	유니버설
헤더	ntddk.h(Ntddk.h 포함)
라이브러리	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL
DDI 규정 준수 규칙	HwStorPortProhibitedDDIs(storport)

추가 정보

IoAttachDeviceToDeviceStack

IoCallDriver