다음을 통해 공유


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에는 핫플러그 디바이스에 대한 지원이 포함되어 있습니다. 핫플러그 디바이스는 장치 관리자 표시되는 RemovalPolicy 값이 ExpectSurpriseRemoval인 디바이스를 나타냅니다. 특정 디바이스가 핫플러그 디바이스인지 여부를 쿼리하려면 IOCTL_STORAGE_GET_HOTPLUG_INFO 요청을 사용합니다. 디바이스의 핫플러그 속성을 설정하려면 IOCTL_STORAGE_SET_HOTPLUG_INFO 요청을 사용합니다.

IOCTL_STORAGE_SET_HOTPLUG_INFO 요청의 경우 STORAGE_HOTPLUG_INFO 구조체의 DeviceHotplug 멤버는 수행되는 작업을 결정합니다. 해당 멤버의 값이 0이 아닌 경우 레지스트리에서 디바이스의 제거 정책 값이 ExpectSurpriseRemoval 로 설정되고 모든 수준의 캐싱이 사용하지 않도록 설정됩니다. DeviceHotplug 값이 0이면 제거 정책이 ExpectOrderlyRemoval로 설정되고 캐싱을 선택적으로 사용하도록 설정할 수 있습니다.

요구 사항

요구 사항
헤더 ntddstor.h(Ntddstor.h 포함)

추가 정보

IOCTL_STORAGE_GET_HOTPLUG_INFO

IOCTL_STORAGE_SET_HOTPLUG_INFO