IOCTL_EHSTOR_BANDMGMT_SET_BAND_LOCATION IOCTL (ehstorbandmgmt.h)

Le proprietà di posizione delle bande in un dispositivo di archiviazione gestito da banda vengono modificate con la richiesta di IOCTL_EHSTOR_BANDMGMT_SET_BAND_LOCATION .

Codice principale

IRP_MJ_DEVICE_CONTROL

Buffer di input

Il buffer in Irp-AssociatedIrp.SystemBuffer> deve contenere una struttura SET_BAND_LOCATION_PARAMETERS seguita dalle strutture AUTH_KEY e BAND_LOCATION_INFO.

Se il membro AuthKeyOffset di SET_BAND_LOCATION_PARAMETERS è impostato su EHSTOR_BANDMGR_NO_KEY, i dati di input nel buffer di sistema non devono includere una struttura AUTH_KEY .

Lunghezza del buffer di input

Parameters.DeviceIoControl.InputBufferLength indica le dimensioni, in byte, del buffer, che devono essere almeno sizeof (SET_BAND_LOCATION_PARAMETERS) + sizeof(AUTH_KEY) + sizeof(BAND_LOCATION_INFO).

Buffer di output

Nessuno.

Lunghezza del buffer di output

Nessuno.

Blocco dello stato

È possibile restituire uno dei valori seguenti nel campo Stato .

Valore di stato	Descrizione
STATUS_SUCCESS	Le proprietà di posizione per la banda sono state modificate.
STATUS_INVALID_DEVICE_REQUEST	Il dispositivo di archiviazione non supporta la gestione della banda.
STATUS_INVALID_BUFFER_SIZE	La dimensione del buffer di input non è valida.
STATUS_INVALID_PARAMETER	Le informazioni nel buffer di input non sono valide.
STATUS_NOT_FOUND	La banda non è stata trovata per i criteri di selezione specificati.
STATUS_ACCESS_DENIED	La chiave di autenticazione specificata non è valida.
STATUS_IO_DEVICE_ERROR	Comunicazione non riuscita. Il dispositivo di archiviazione potrebbe non essere compatibile con i protocolli di sicurezza.

Commenti

I dati in LBA che rimangono dopo il ridimensionamento non sono modificati dall'operazione. Inoltre, non è necessario smontare un volume durante un'operazione di ridimensionamento se l'intervallo LBA che si estende sul volume rimane all'interno della banda dopo il ridimensionamento.

Le modifiche apportate alla tabella di banda da questa richiesta vengono sottoposte al commit atomico del dispositivo prima del completamento della richiesta IOCTL. Pertanto, è garantito che la banda venga modificata con tutte le relative proprietà impostate o nessuna proprietà impostata a tutti se si verifica un sistema o un guasto di alimentazione.

Il membro BandSize di BAND_LOCATION_INFO deve essere maggiore di 0. Questo IOCTL non può ridimensionare una banda a 0 per causare un'eliminazione di banda. Per eliminare una banda, viene utilizzata la richiesta di IOCTL_EHSTOR_BANDMGMT_DELETE_BAND .

Se BAND_LOCATION_INFO specifica le proprietà per la banda globale, BandStart deve essere impostato su 0 e BandSize deve essere impostato su -1.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile a partire da Windows 8
Intestazione	ehstorbandmgmt.h (include EhStorBandMgmt.h)

Vedi anche

BAND_LOCATION_INFO

IOCTL_EHSTOR_BANDMGMT_DELETE_BAND

SET_BAND_LOCATION_PARAMETERS