IOCTL_EHSTOR_BANDMGMT_CREATE_BAND IOCTL (ehstorbandmgmt.h)
Le nuove bande vengono create in un dispositivo di archiviazione gestito da band con la richiesta di IOCTL_EHSTOR_BANDMGMT_CREATE_BAND . Una nuova band viene aggiunta alla tabella delle voci band, che include le proprietà di sicurezza e posizione band.
Codice principale
Buffer di input
Il buffer in Irp-AssociatedIrp.SystemBuffer> deve contenere una struttura CREATE_BAND_PARAMETERS seguita dalle strutture BAND_LOCATION_INFO,BAND_SECURITY_INFO e AUTH_KEY.
Se il membro AuthKeyOffset di CREATE_BAND_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 deve essere almeno sizeof (CREATE_BAND_PARAMETERS) + sizeof(BAND_LOCATION_INFO) + sizeof (BAND_SECURITY_INFO) + sizeof(AUTH_KEY).
Buffer di output
Il buffer di output in Irp-AssociatedIrp.SystemBuffer> contiene facoltativamente un valore ULONG per l'identificatore della banda appena creata.
Lunghezza del buffer di output
Parameters.DeviceIoControl.OutputBufferLength deve essere almeno sizeof(ULONG) per ricevere l'identificatore della banda. Se la restituzione dell'identificatore della banda non è desiderata, impostare Parameters.DeviceIoControl.OutputBufferLength su 0.
Blocco dello stato
Uno dei valori seguenti può essere restituito nel campo Stato .
| Valore stato | Descrizione |
|---|---|
| STATUS_SUCCESS | La nuova band è stata creata. |
| STATUS_INVALID_DEVICE_REQUEST | Il dispositivo di archiviazione non supporta la gestione della banda. |
| STATUS_INVALID_BUFFER_SIZE | Le dimensioni del buffer di input non sono valide. |
| STATUS_INVALID_PARAMETER | Le informazioni nel buffer di input non sono valide. |
| STATUS_CONFLICTING_ADDRESSES | La band non è stata creata a causa di posizioni sovrapposte. |
| STATUS_INSUFFICIENT_RESOURCES | La band non è stata creata perché la tabella band è già piena. |
| STATUS_IO_DEVICE_ERROR | Comunicazione non riuscita. Il dispositivo di archiviazione potrebbe non essere compatibile con i protocolli di sicurezza. |
Commenti
L'assegnazione di una chiave di autenticazione a una banda appena creata è facoltativa. Se non viene fornita alcuna chiave, in cui viene usata una chiave di autenticazione predefinita in cui AuthKeyOffset = EHSTOR_BANDMGR_NO_KEY nella struttura CREATE_BAND_PARAMETERS . Tuttavia, questo lascia la banda vulnerabile a un altro chiamante che può prendere il controllo sulla banda immediatamente dopo la sua creazione modificando la chiave di autenticazione. È consigliabile assegnare una chiave di autenticazione non predefinita alla banda in fase di creazione.
Le modifiche apportate alla tabella band da questa richiesta vengono eseguite con il commit atomico del dispositivo prima del completamento della richiesta IOCTL. Pertanto, è garantito che la banda venga creata con tutte le relative proprietà impostate o non create in tutto il caso in cui si verifichi un sistema o un errore di alimentazione.
La posizione della nuova banda non deve sovrapporsi a una banda esistente o questa richiesta avrà esito negativo con STATUS_CONFLICTING_ADDRESSES.
Se la banda viene sbloccata, i membri ReadLock o WriteLock di BAND_SECURITY_INFO sono impostati su FALSE e CREATEBAND_AUTHKEY_CACHING_ENABLED è impostato nel membro Flags di CREATE_BAND_PARAMETERS, la memorizzazione nella cache delle credenziali è abilitata. Il driver silo di autenticazione memorizza nella cache la chiave di autenticazione della banda in memoria. Ciò consente al driver silo di autenticare automaticamente l'accesso host al dispositivo di archiviazione quando è necessaria la manutenzione del volume, ad esempio il ridimensionamento della banda.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile a partire da Windows 8 |
| Intestazione | ehstorbandmgmt.h (include EhStorBandMgmt.h) |