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 を含む)

こちらもご覧ください

IOCTL_STORAGE_GET_HOTPLUG_INFO

IOCTL_STORAGE_SET_HOTPLUG_INFO