IoGetDeviceAttachmentBaseRef 函式 (ntifs.h)
IoGetDeviceAttachmentBaseRef 例程會傳回文件系統或設備驅動器堆棧中最低層級裝置物件的指標。
語法
PDEVICE_OBJECT IoGetDeviceAttachmentBaseRef(
[in] PDEVICE_OBJECT DeviceObject
);
參數
[in] DeviceObject
堆疊中裝置物件的指標。
傳回值
IoGetDeviceAttachmentBaseRef 會傳回文件系統或設備驅動器堆棧底部裝置物件的指標。 如果指定的裝置物件未連結至驅動程式堆疊,IoGetDeviceAttachmentBaseRef 會傳回 deviceObject 中的裝置物件指標。
言論
文件系統篩選驅動程式通常會呼叫 IoGetDeviceAttachmentBaseRef,以取得文件系統驅動程式堆疊中的最低層級裝置物件。 當篩選驅動程式收到文件系統註冊或取消註冊為使用中文件系統的通知時,通常會這麼做。 篩選驅動程式的通知回呼例程會 呼叫 ioGetDeviceAttachmentBaseRef,以取得文件系統控件裝置物件的指標,然後呼叫 ObQueryNameString,以擷取此物件的名稱進行偵錯。
IoGetDeviceAttachmentBaseRef 遞增堆棧底部裝置對象的參考計數。 因此,每次成功呼叫 IoGetDeviceAttachmentBaseRef,都必須比對 ObDereferenceObject 的後續呼叫。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows 2000 SP4 更新匯總;Windows XP |
目標平臺 | 普遍 |
標頭 | ntifs.h (include Ntifs.h) |
連結庫 | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | <= DISPATCH_LEVEL |
另請參閱
IoRegisterFsRegistrationChange