IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA IOCTL (ehstorbandmgmt.h)

I metadati associati a una banda vengono recuperati con una richiesta di IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA . I metadati per una banda fungono da area dati per un'applicazione key manager.

Codice principale

IRP_MJ_DEVICE_CONTROL

Buffer di input

Il buffer di input in Irp-AssociatedIrp.SystemBuffer> deve contenere una struttura GET_BAND_METADATA_PARAMETERS.

Lunghezza del buffer di input

Parameters.DeviceIoControl.InputBufferLength indica le dimensioni, in byte, del buffer, che deve essere almeno sizeof (GET_BAND_METADATA_PARAMETERS).

Buffer di output

Il buffer di output in Irp-AssociatedIrp.SystemBuffer> contiene una matrice di byte di metadati band specificati da GET_BAND_METADATA_PARAMETERS.

Lunghezza del buffer di output

Lunghezza di una struttura GET_BAND_METADATA_PARAMETERS .

Blocco dello stato

Il campo Informazioni contiene il numero di byte restituiti nel buffer di output. Uno dei valori seguenti può essere restituito nel campo Stato .

Valore stato	Descrizione
STATUS_SUCCESS	I metadati sono stati restituiti nel buffer di sistema.
STATUS_INVALID_DEVICE_REQUEST	Il dispositivo di archiviazione non supporta la gestione della banda.
STATUS_INVALID_BUFFER_SIZE	Le dimensioni del buffer di output non sono corrette.
STATUS_INVALID_PARAMETER	Le informazioni nel buffer di input non sono valide.
STATUS_NOT_FOUND	La band non è stata trovata per i criteri di selezione specificati.
STATUS_IO_DEVICE_ERROR	Comunicazione non riuscita. Il dispositivo di archiviazione potrebbe non essere compatibile con i protocolli di sicurezza.

Commenti

L'autenticazione per questo IOCTL non è necessaria e una chiave di autenticazione non è inclusa come input.

Requisiti

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

Vedi anche

BAND_LOCATION_INFO

BAND_SECURITY_INFO

CREATE_BAND_PARAMETERS