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 연결된 디바이스 개체에 대한 포인터를 받습니다.
반환 값
IoAttachDeviceToDeviceStackSafeSourceDeviceTargetDevice위에 성공적으로 연결되면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 STATUS_NO_SUCH_DEVICE 반환합니다.
발언
IoAttachDeviceToDeviceStack마찬가지로 IoAttachDeviceToDeviceStackSafe 동일한 IRP가 스택의 각 드라이버에 전송되도록 드라이버 간에 계층을 설정합니다. 그러나 IoAttachDeviceToDeviceStack달리 IoAttachDeviceToDeviceStackSafe 필터 드라이버가 SourceDevice 개체의 AttachedToDeviceObject 필드의 주소를 전달하는 데 사용하는 AttachedToDeviceObject 추가 매개 변수가 있습니다. IoAttachDeviceToDeviceStackSafe I/O 시스템 데이터베이스 잠금을 유지하면서 이 필드를 업데이트합니다. 이 잠금을 보유하므로 IoAttachDeviceToDeviceStackSafeSourceDevice 개체가 AttachedToDeviceObject 필드가 업데이트되기 전에 IRP를 받은 경우 발생할 수 있는 경합 상태를 방지합니다.
파일 시스템 필터 드라이버는 IoAttachDeviceToDeviceStackSafe 호출하여 파일 시스템 또는 다른 필터 드라이버에 속한 디바이스 개체(TargetDevice) 위에 자체 필터 디바이스 개체(SourceDevice)를 연결합니다. AttachedToDeviceObject 전송된 후속 I/O 요청은 필터 드라이버에 의해 먼저 수신되며, 필터 드라이버는 이를 처리하고 IoCallDriver호출하여 스택의 다음 드라이버로 전달합니다.
TargetDevice 지정된 디바이스 개체가 현재 드라이버 스택의 맨 위에 있는 경우 SourceDeviceTargetDevice직접 연결됩니다. 이 경우 targetDevice 반환된 AttachedToDeviceObject 포인터가 같습니다.
하나 이상의 필터 디바이스 개체가 드라이버 스택의 TargetDevice 위에 이미 연결되어 있는 경우 IoAttachDeviceToDeviceStackSafeSourceDevice 최상위 필터 디바이스 개체에 연결합니다. 후자에 대한 포인터는 AttachedToDeviceObject반환됩니다.
스택의 맨 위에 연결된 직후에 SourceDevice 드라이버 스택의 맨 위에 있습니다. 그러나 이것이 반드시 SourceDevice 드라이버 스택의 맨 위에 유지된다는 것을 의미하지는 않습니다. 다른 필터는 스택의 SourceDevice 위에 자체 필터 디바이스 개체를 연결할 수 있습니다.
IoAttachDeviceToDeviceStackSafeSourceDevice에서 가리키는 디바이스 개체의 AlignmentRequirement 멤버를 설정합니다. 다음 하위 디바이스 개체의 해당 값으로SourceDeviceStackSize 다음 하위 개체의 값과 1을 더한 값으로 설정합니다.
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | 이 루틴은 Windows 2000 SP4(서비스 팩 4) 및 Windows XP 이상용 업데이트 롤업에서 사용할 수 있습니다. |
| 대상 플랫폼 | 보편적 |
| 헤더 | ntddk.h(Ntddk.h 포함) |
| 라이브러리 | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |
| DDI 규정 준수 규칙 | HwStorPortProhibitedDDIs(storport) |