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) |