IoAttachDeviceToDeviceStack 函式 (wdm.h)

IoAttachDeviceToDeviceStack 例程會將呼叫端的裝置物件附加至鏈結中最高的裝置物件，並傳回先前最高裝置物件的指標。

語法

PDEVICE_OBJECT IoAttachDeviceToDeviceStack(
  [in] PDEVICE_OBJECT SourceDevice,
  [in] PDEVICE_OBJECT TargetDevice
);

[in] SourceDevice

呼叫端所建立裝置物件的指標。

[in] TargetDevice

另一個驅動程式裝置物件的指標，例如先前呼叫 IoGetDeviceObjectPointer所傳回的指標。

IoAttachDeviceToDeviceStack 會傳回 SourceDevice 所附加裝置物件的指標。如果 TargetDevice 有額外的驅動程式分層，則傳回的裝置對象指標可能與 TargetDevice 不同。

IoAttachDeviceToDeviceStack 如果無法附加裝置物件，就會傳回 NULL ，例如，目標裝置正在卸除。

IoAttachDeviceToDeviceStack 會在驅動程式之間建立分層，讓相同的 IRP 傳送至鏈結中的每個驅動程式。

中繼驅動程式可以在初始化期間使用此例程，將自己的裝置物件附加至另一個驅動程式的裝置物件。傳送至 TargetDevice 的後續 I/O 要求會先傳送至中繼驅動程式。

這個例程會將 SourceDevice 中的 AlignmentRequirement 設定為下一個較低裝置物件中的值，並將 StackSize 設定為下一個較低物件的值加上一個。

驅動程式寫入器必須小心呼叫此例程，才能在驅動程式之上必須分層的任何驅動程式。 IoAttachDeviceToDeviceStack 會將 SourceDevice 附加至鏈結中目前分層的最高裝置物件，而且無法判斷驅動程式是否以正確的順序分層。

藉由呼叫 IoGetDeviceObjectPointer 取得目標裝置指標的驅動程式，應該使用 IoGetDeviceObject 所傳回的檔案對象指標呼叫 ObDereferenceObject，在卸離檔案物件之前釋放其檔案對象的參考，例如，卸除這類較高層級驅動程式時。

需求	值
最低支援的用戶端	從 Windows 2000 開始提供。
目標平台	Universal
標頭	wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
程式庫	NtosKrnl.lib
Dll	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL
DDI 合規性規則	AddDevice (wdm) 、 HwStorPortProhibitedDIs (storport ) 、 PnpSameDeviceObject (wdm)