IoAttachDevice 함수(wdm.h)

IoAttachDevice 루틴은 호출자의 디바이스 개체를 명명된 대상 디바이스 개체에 연결하므로 대상 디바이스에 바인딩된 I/O 요청이 먼저 호출자에게 라우팅됩니다.

구문

NTSTATUS IoAttachDevice(
  [in]  PDEVICE_OBJECT  SourceDevice,
  [in]  PUNICODE_STRING TargetDevice,
  [out] PDEVICE_OBJECT  *AttachedDevice
);

매개 변수

[in] SourceDevice

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

[in] TargetDevice

지정된 SourceDevice 를 연결할 디바이스 개체의 이름을 포함하는 버퍼에 대한 포인터입니다.

[out] AttachedDevice

포인터에 대해 호출자가 할당한 스토리지에 대한 포인터입니다. 반환할 때 첨부 파일이 성공하면 대상 디바이스 개체에 대한 포인터를 포함합니다.

반환 값

IoAttachDevice는 다음 NTSTATUS 값 중 하나를 반환할 수 있습니다.

설명

IoAttachDevice는 체인의 각 드라이버에 동일한 IRP를 보낼 수 있도록 드라이버 간에 계층을 설정합니다.

이 루틴은 초기화 중에 중간 드라이버에서 사용됩니다. 이러한 드라이버를 사용하면 원래 디바이스에 대한 모든 요청이 먼저 중간 드라이버에 제공되도록 자체 디바이스 개체를 다른 디바이스에 연결할 수 있습니다.

호출자는 계층화된 드라이버의 기존 체인 맨 위에만 계층화할 수 있습니다. IoAttachDevice는 TargetDevice 위에 계층화된 가장 높은 디바이스 개체를 검색하고 해당 개체(TargetDevice일 수 있습니다)에 연결합니다. 따라서 상위 수준이어야 하는 드라이버가 이미 대상 디바이스 위에 계층화된 경우 이 루틴을 호출해서는 안 됩니다.

스토리지 스택의 파일 시스템 드라이버 및 드라이버에 대해 IoAttachDevice 는 FILE_READ_ATTRIBUTES 사용하여 대상 디바이스를 연 다음 IoGetRelatedDeviceObject를 호출합니다. 이렇게 하면 파일 시스템이 탑재되지 않습니다. 따라서 IoAttachDevice 를 성공적으로 호출하면 파일 시스템 드라이버가 아닌 스토리지 드라이버의 디바이스 개체가 반환됩니다.

이 루틴은 SourceDevice의 AlignmentRequirement를 다음 하위 디바이스 개체의 값으로 설정하고 StackSize를 다음 하위 개체의 값과 1을 더한 값으로 설정합니다.

요구 사항

추가 정보

DEVICE_OBJECT

IoAttachDeviceToDeviceStack

IoAttachDeviceToDeviceStackSafe

IoCreateDevice

IoDetachDevice

IoGetRelatedDeviceObject