STORAGE_HOTPLUG_INFO 構造体 (winioctl.h)
デバイスのホットプラグ情報に関する情報を提供します。
構文
typedef struct _STORAGE_HOTPLUG_INFO {
DWORD Size;
BOOLEAN MediaRemovable;
BOOLEAN MediaHotplug;
BOOLEAN DeviceHotplug;
BOOLEAN WriteCacheEnableOverride;
} STORAGE_HOTPLUG_INFO, *PSTORAGE_HOTPLUG_INFO;
メンバー
Size
この構造体のサイズ (バイト単位)。 呼び出し元は、このメンバーを に設定する sizeof(STORAGE_HOTPLUG_INFO)必要があります。
MediaRemovable
このメンバーが 0 以外の値に設定されている場合、デバイス メディアはリムーバブルです。 それ以外の場合、デバイス メディアはリムーバブルではありません。
MediaHotplug
このメンバーが 0 以外の値に設定されている場合、メディアはロックできません。 それ以外の場合、デバイス メディアはロック可能です。
DeviceHotplug
このメンバーが 0 以外の値に設定されている場合、デバイスは hotplug デバイスです。 それ以外の場合、デバイスはホットプラグ デバイスではありません。
WriteCacheEnableOverride
予約;値を NULL に設定 します。
注釈
Size メンバーの値は、メンバーが将来この構造体に追加されるため、この構造体のバージョンも識別します。 Size メンバーの値が のsizeof(STORAGE_HOTPLUG_INFO)場合、構造体の現在のバージョンは、コンパイルしたバージョンと同じです。 値が でない sizeof(STORAGE_HOTPLUG_INFO)場合、現在のバージョンには追加のメンバーが含まれます。
hotplug デバイスとは、デバイス マネージャーに表示される RemovalPolicy 値が ExpectSurpriseRemoval であるデバイスを指します。 特定のデバイスがホットプラグ デバイスであるかどうかを照会するには、 IOCTL_STORAGE_GET_HOTPLUG_INFO 操作を使用します。 デバイスの hotplug プロパティを設定するには、 IOCTL_STORAGE_SET_HOTPLUG_INFO 操作を使用します。
IOCTL_STORAGE_SET_HOTPLUG_INFO操作では、この構造体の DeviceHotplug メンバーの値のみが設定されます。 そのメンバーの値が設定されている場合、指定したデバイスの削除ポリシーが ExpectSurpriseRemoval に設定され、すべてのレベルのキャッシュが無効になります。 そのメンバーの値が設定されていない場合は、指定したデバイスの削除ポリシーが ExpectOrderlyRemoval に設定され、キャッシュを選択的に有効にすることができます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP |
| サポートされている最小のサーバー | Windows Server 2003 |
| Header | winioctl.h (Windows.h を含む) |