IOCTL_MOUNTDEV_QUERY_SUGGESTED_LINK_NAME IOCTL (mountdev.h)

IOCTL_MOUNTDEV_QUERY_SUGGESTED_LINK_NAME 可讓掛接管理員用戶端,例如裝置或磁碟區驅動程式,建議其相關聯磁碟區的驅動器號或連結名稱。

掛接管理員用戶端對此IOCTL的支援是選擇性的。

主要程序代碼

IRP_MJ_DEVICE_CONTROL

輸入緩衝區

沒有。

輸入緩衝區長度

沒有。

輸出緩衝區

用戶端驅動程序必須在 Irp->AssociatedIrp.SystemBuffer的緩衝區開頭放置類型 MOUNTDEV_SUGGESTED_LINK_NAME 的可變長度結構。 用戶端驅動程序必須在這個結構 Name 成員所指向的位址插入建議的持續性名稱。

輸出緩衝區長度

Parameters.DeviceIoControl.OutputBufferLength 在 IRP 的 I/O 堆棧位置,表示輸出緩衝區的大小,以位元組為單位,輸出緩衝區的大小必須大於或等於 sizeof(MOUNTDEV_SUGGESTED_LINK_NAME)

輸入/輸出緩衝區

N/A

輸入/輸出緩衝區長度

N/A

狀態區塊

如果作業成功,[資訊] 字段會設定為傳回的位元組總數,並將 [狀態] 字段設定為 [STATUS_SUCCESS]。

如果 outputBufferLength 小於 sizeof(MOUNTDEV_SUGGESTED_LINK_NAME),Status 字段會設定為 STATUS_INVALID_PARAMETER。

如果 OutputBufferLength 小於輸出數據的總長度,Status 字段會設定為 STATUS_BUFFER_OVERFLOW,且 [資訊] 字段會設定為 sizeof(MOUNTDEV_SUGGESTED_LINK_NAME)。

言論

有些掛接管理員客戶端能夠在系統重新啟動時追蹤其驅動器號,而不需要掛接管理員的協助。 這類用戶端可以將建議的驅動器號名稱傳送給掛接管理員,以回應此 IOCTL。 如果掛接管理員的資料庫尚未包含用戶端磁碟區的永續性驅動器號名稱,則掛接管理員會使用建議的名稱。 否則,它會忽略建議,並在其永續性名稱資料庫中使用驅動器號名稱。

驅動器號名稱必須包含物件命名空間中符號連結的完整路徑,而且必須具有傳統的 MS-DOS 語法。 例如,驅動器號 「D」 必須以下列方式表示:「\DosDevices\D:“。 “?? 的替代符號鏈接路徑無法使用 \D:“ 不能使用符號鏈接的縮寫,例如 ”D:“。

此函式的實作者不得線程同步處理,而且不得進行封鎖和/或進程間通訊 (IPC) 函式呼叫。

如需詳細資訊,請參閱 在記憶體類別驅動程式中支援掛接管理員要求

要求

要求 價值
標頭 mountdev.h (包括 Mountdev.h)

另請參閱

MOUNTDEV_SUGGESTED_LINK_NAME