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 以外の値に設定すると、デバイスはホットプラグ デバイスになります。 ゼロに設定した場合、デバイスはホットプラグ デバイスではありません。
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 に設定され、キャッシュを選択的に有効にすることができます。
必要条件
要件 | 価値 |
---|---|
ヘッダー | ntddstor.h (Ntddstor.h を含む) |