IOCTL_EHSTOR_BANDMGMT_ACTIVATE IOCTL(ehstorbandmgmt.h)

아티클
08/07/2023

이 IOCTL_EHSTOR_BANDMGMT_ACTIVATE 요청은 스토리지 디바이스에서 보안 기능 및 대역 관리를 활성화하기 위해 전송됩니다. 요청에는 활성화 옵션 및 인증 키가 포함됩니다.

주 코드

입력 버퍼

Irp-AssociatedIrp.SystemBuffer>의 입력 버퍼에는 ACTIVATE_REVERT_PARAMETERS 구조체가 포함되어 있습니다. ACTIVATE_REVERT_PARAMETERS다음과 같이 ehstorbandmgmt.h 에 선언됩니다.

typedef struct _ACTIVATE_REVERT_PARAMETERS
{
    ULONG           StructSize;
    ULONG           Flags;
    ULONG           AuthKeyOffset;
} ACTIVATE_REVERT_PARAMETERS;

시스템 버퍼의 다음 ACTIVATE_REVERT_PARAMETERSAUTH_KEY 구조입니다. 인증 키에 대한 키 데이터 바이트를 보유합니다. AUTH_KEY다음과 같이 ehstorbandmgmt.h 로 선언됩니다.

typedef struct _AUTH_KEY
{
    ULONG   KeySize;
    UCHAR   Key[ANYSIZE_ARRAY];
} AUTH_KEY;

입력 버퍼 길이

ACTIVATE_REVERT_PARAMETERS 구조체의 길이입니다.

출력 버퍼

없음

출력 버퍼 길이

없음

상태 블록

상태 필드에 다음 값 중 하나를 반환할 수 있습니다.

상태 값	Description
STATUS_SUCCESS	스토리지 디바이스의 보안 기능이 활성화되었습니다.
STATUS_INVALID_DEVICE_REQUEST	스토리지 디바이스는 대역 관리를 지원하지 않습니다.
STATUS_INVALID_BUFFER_SIZE	입력 버퍼 크기가 잘못되었습니다.
STATUS_INVALID_PARAMETER	입력 버퍼의 정보가 잘못되었습니다.
STATUS_ACCESS_DENIED	인증 키가 잘못되었습니다. 활성화가 거부되었습니다.
STATUS_DEVICE_CONFIGURATION_ERROR	시스템에서 지원되는 모드에서 디바이스를 구성할 수 없습니다.
STATUS_IO_DEVICE_ERROR	통신이 실패했습니다. 스토리지 디바이스가 보안 프로토콜과 호환되지 않을 수 있습니다.
STATUS_INVALID_DEVICE_STATE	스토리지 디바이스가 이미 활성화되어 있습니다.
STATUS_NOT_SUPPORTED	그룹 정책 설정으로 인해 디바이스의 보안 기능이 활성화되지 않았습니다.

설명

이 요청에서 STATUS_SUCCESS 반환되는 경우 드라이버 또는 애플리케이션은 IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES 요청을 보내 디바이스의 사용 가능한 대역 관리 기능을 검색할 수 있습니다.

IOCTL_EHSTOR_BANDMGMT_ACTIVATE 성공적으로 반환되기 전에 디바이스가 활성화되지 않습니다. 디바이스가 활성화될 때까지 성공적으로 반환되는 유일한 밴드 관리 IOCTL은 IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES. 활성화 후 나머지 대역 관리 IOCTL을 사용할 수 있습니다.

고급 스토리지 디바이스의 활성화는 시스템의 그룹 정책 설정에 의해 제어됩니다. HKLM\Software\Policies\Microsoft\Windows\EnhancedStorageDevices\TCGSecurityActivationDisabled의 레지스트리 값은 보안 활성화를 사용할 수 있는지 여부를 결정합니다. REG_DWORD 값 0은 스토리지 디바이스에서 보안 활성화를 허용합니다. 그렇지 않으면 값이 1이면 보안 활성화가 비활성화되고 IOCTL_EHSTOR_BANDMGMT_ACTIVATE 요청이 STATUS_NOT_SUPPORTED 함께 반환됩니다 .

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 8 사용하여 사용할 수 있습니다.
머리글	ehstorbandmgmt.h(EhStorBandMgmt.h 포함)

추가 정보

IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES

IOCTL_EHSTOR_BANDMGMT_REVERT