IOCTL_MOUNTDEV_QUERY_SUGGESTED_LINK_NAME IOCTL (mountdev.h)
IOCTL_MOUNTDEV_QUERY_SUGGESTED_LINK_NAME では、デバイス ドライバーやボリューム ドライバーなどのマウント マネージャー クライアントが、関連付けられているボリュームのドライブ文字またはリンク名を提案できます。
マウント マネージャー クライアントによるこの IOCTL のサポートは省略可能です。
メジャー コード
入力バッファー
何一つ。
入力バッファーの長さ
何一つ。
出力バッファー
クライアント ドライバーは、バッファーの先頭に MOUNTDEV_SUGGESTED_LINK_NAME 型の可変長構造体 Irp->AssociatedIrp.SystemBufferを配置する必要があります。 クライアント ドライバーは、提案された永続的な名前を、この構造体の Name メンバーが指すアドレスに挿入する必要があります。
出力バッファーの長さ
IRP の I/O スタック位置の Parameters.DeviceIoControl.OutputBufferLength は、出力バッファーのサイズ (バイト単位) を示します。これは、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 を含む) |