IOCTL_EHSTOR_BANDMGMT_SET_BAND_LOCATION IOCTL (ehstorbandmgmt.h)
As propriedades de localização de bandas em um dispositivo de armazenamento gerenciado por banda são modificadas com a solicitação IOCTL_EHSTOR_BANDMGMT_SET_BAND_LOCATION.
Código principal
Buffer de entrada
O buffer em >>AssociatedIrp.SystemBuffer deve conter uma estrutura de SET_BAND_LOCATION_PARAMETERS seguida pelas estruturas AUTH_KEY e BAND_LOCATION_INFO.
Se o AuthKeyOffset membro do SET_BAND_LOCATION_PARAMETERS estiver definido como EHSTOR_BANDMGR_NO_KEY, os dados de entrada no buffer do sistema não precisarão incluir uma estrutura AUTH_KEY.
Comprimento do buffer de entrada
Parameters.DeviceIoControl.InputBufferLength indica o tamanho, em bytes, do buffer, que deve ter pelo menos tamanho de (SET_BAND_LOCATION_PARAMETERS) + sizeof(AUTH_KEY) + sizeof(BAND_LOCATION_INFO).
Buffer de saída
Nenhum.
Comprimento do buffer de saída
Nenhum.
Bloco de status
Um dos valores a seguir pode ser retornado no campo status do.
| Valor do status | Descrição |
|---|---|
| STATUS_SUCCESS | As propriedades de localização da banda foram alteradas. |
| STATUS_INVALID_DEVICE_REQUEST | O dispositivo de armazenamento não dá suporte ao gerenciamento de banda. |
| STATUS_INVALID_BUFFER_SIZE | O tamanho do buffer de entrada é inválido. |
| STATUS_INVALID_PARAMETER | As informações no buffer de entrada são inválidas. |
| STATUS_NOT_FOUND | A banda não foi encontrada para os critérios de seleção fornecidos. |
| STATUS_ACCESS_DENIED | A chave de autenticação fornecida não é válida. |
| STATUS_IO_DEVICE_ERROR | Falha na comunicação. O dispositivo de armazenamento pode ser incompatível com protocolos de segurança. |
Observações
Os dados em LBAs que permanecem após o redimensionamento não são modificados pela operação. Além disso, é desnecessário desmontar um volume durante uma operação de redimensionamento se o intervalo LBA que abrange o volume permanecer dentro da banda após o redimensionamento.
As alterações feitas na tabela de banda por essa solicitação são confirmadas no dispositivo atomicamente antes da conclusão da solicitação IOCTL. Portanto, é garantido que a banda seja modificada com todas as suas propriedades definidas ou nenhuma propriedade definida caso ocorra uma falha de energia ou sistema.
O membro BandSize do BAND_LOCATION_INFO deve ser maior que 0. Este IOCTL não pode redimensionar uma banda para 0 para causar uma exclusão de banda. Para excluir uma banda, a solicitação IOCTL_EHSTOR_BANDMGMT_DELETE_BAND é usada.
Se BAND_LOCATION_INFO especificar propriedades para a banda global, bandstart deverá ser definido como 0 e bandSize deve ser definido como –1.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível a partir do Windows 8 |
| cabeçalho | ehstorbandmgmt.h (inclua EhStorBandMgmt.h) |