estrutura BAND_MANAGEMENT_CAPABILITIES (ehstorbandmgmt.h)

Artigo
02/06/2025

A estrutura BAND_MANAGEMENT_CAPABILITIES contém os recursos de segurança disponíveis para um dispositivo de armazenamento. Essa estrutura é retornada no buffer do sistema pela solicitação IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES.

Sintaxe

typedef struct _BAND_MANAGEMENT_CAPABILITIES {
  ULONG     StructSize;
  ULONG     Capabilities;
  ULONGLONG KeyProtectionMechanism;
  ULONG     MinAuthKeyLength;
  ULONG     MaxAuthKeyLength;
  ULONG     MaxBandCount;
  ULONG     MaxSimultaneousReencryptionCount;
  ULONG     BandMetadataSize;
} BAND_MANAGEMENT_CAPABILITIES, *PBAND_MANAGEMENT_CAPABILITIES;

Membros

StructSize

O tamanho dessa estrutura em bytes. Definido como tamanho de(BAND_MANAGEMENT_CAPABILITIES).

Capabilities

Sinalizadores de funcionalidade de segurança para um dispositivo de armazenamento. Esse é um valor OR bit a bit dos sinalizadores a seguir.

Valor	Significado
CAPS_ACTIVATED	Se definido, os membros da funcionalidade dessa estrutura estarão disponíveis. Caso contrário, os membros restantes dessa estrutura não são válidos.
CAPS_BANDCROSSING_SUPPORTED	O dispositivo de armazenamento dá suporte a leituras e gravações em várias bandas. Se esse sinalizador não estiver definido, leituras simples ou gravações que abrangem várias bandas serão divididas em várias solicitações de E/S para um dispositivo.
CAPS_SID_SECURED	A autoridade sid está protegida. Se definido, o pin SID padrão não poderá ser usado para modificar a configuração de segurança do dispositivo de armazenamento.

KeyProtectionMechanism

O mecanismo usado para proteger as chaves de mídia. Este membro está definido como um dos seguintes.

Valor	Significado
0	As chaves não estão protegidas.
MEDIAKEY_PROTECTEDBY_VENDORSCHEME	As chaves são protegidas por um método fornecido pelo fornecedor. Não use. Não há suporte para essa opção.
MEDIAKEY_PROTECTEDBY_AUTHKEY	As chaves são criptografadas por chaves derivadas de chaves de autenticação de banda. A derivação de chave resulta em perda de entropia insignificante dos dados de autenticação de banda.

MinAuthKeyLength

O comprimento mínimo, em bytes, da autenticação de banda ou das chaves de apagamento aceitas pelo dispositivo de armazenamento.

MaxAuthKeyLength

O comprimento máximo, em bytes, da autenticação de banda ou das chaves de apagamento aceitas pelo dispositivo de armazenamento.

MaxBandCount

O número máximo de bandas simultâneas configuradas no dispositivo de armazenamento. Isso inclui a banda global.

MaxSimultaneousReencryptionCount

O número de criptografias simultâneas de banda que o hardware no dispositivo dá suporte. Se esse membro for 0, não há suporte para criptografias de banda controladas por hardware.

BandMetadataSize

O tamanho, em bytes, do repositório de metadados por banda.

Observações

Se CAPS_ACTIVATED não estiver definido em Recursos, a funcionalidade de segurança poderá ser ativada com a solicitação IOCTL_EHSTOR_BANDMGMT_ACTIVATE.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível a partir do Windows 8
cabeçalho	ehstorbandmgmt.h (inclua EhStorBandMgmt.h)

Consulte também

IOCTL_EHSTOR_BANDMGMT_ACTIVATE

IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES

Compartilhar via