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