estructura ENUMERATE_BANDS_PARAMETERS (ehstorbandmgmt.h)

Artículo
02/26/2024

La estructura ENUMERATE_BANDS_PARAMETERS se usa para seleccionar qué entradas de información de banda se seleccionan para devolver de una solicitud de IOCTL_EHSTOR_BANDMGMT_ENUMERATE_BANDS .

Sintaxis

typedef struct _ENUMERATE_BANDS_PARAMETERS {
  ULONG         StructSize;
  ULONG         Flags;
  ULONG         Reserved;
  ULONG         BandId;
  LARGE_INTEGER BandStart;
  LARGE_INTEGER BandSize;
} ENUMERATE_BANDS_PARAMETERS, *PENUMERATE_BANDS_PARAMETERS;

Miembros

StructSize

Tamaño de esta estructura en bytes. Establezca en sizeof(ENUMERATE_BANDS_PARAMETERS).

Flags

Marcas de enumeración de banda. Este valor es una combinación OR bit a bit de lo siguiente.

Valor	Significado
ENUMBANDS_ENUM_ALL_BANDS	Se devuelven todas las bandas. Cuando se establece esta marca, se omiten los miembros BandId, BandStart y BandSize .
ENUMBANDS_REPORT_CRYPTO_ALGO	Incluya información del algoritmo de cifrado multimedia en el miembro SecurityInfo de BAND_TABLE_ENTRY.

Reserved

Reservado.

BandId

Identificador de una sola banda para la que se va a devolver información. BandSize debe ser 0 cuando se selecciona una sola banda con BandId. Para usar BandStart y BandSize en lugar de BandId para seleccionar una banda, establezca BandId = (ULONG) –1.

BandStart

Ubicación inicial de bytes en el dispositivo de almacenamiento para iniciar una búsqueda de banda. Se intenta hacer coincidir una banda en o después de BandStart.

BandSize

Valor de coincidencia de tamaño de banda opcional en bytes. Si BandSize == 0 y BandId == –1, BandStart es el único valor de coincidencia para seleccionar una banda. De lo contrario, se selecciona exactamente una banda en BandStart o después de BandStart y bandSize coincidente.

Comentarios

Cuando ENUMBANDS_ENUM_ALL_BANDS no se establece en Flags, se realiza un intento de selección para que coincida con una sola banda. Una sola coincidencia de banda se realiza en función de los valores de BandID, BandStart y BandSize. La prioridad se da a BandID para la selección de banda. Si el miembro BandID 0 y BandID<>MaxBandCount de BAND_MANAGEMENT_CAPABILITIES Si BandID es mayor que 0 y BandID es menor que el miembro MaxBandCount de BAND_MANAGEMENT_CAPABILITIES, bandID se usa como único criterio de selección para una coincidencia de banda. Si BandID == –1, BandStart y BandSize se usan como criterios de coincidencia para seleccionar una banda.

Cuando BandStart y BandSize se usan para hacer coincidir una banda, se devuelve la primera banda configurada en o después de que la ubicación BandStart tenga el tamaño exacto de BandSize . Si BandSize == 0, cuando BandStart es válido, se devuelve la primera banda configurada en o después de que se devuelva BandStart .

Si BandID == 0 o no hay bandas configuradas y Flags no se establece en ENUMBANDS_ENUM_ALL_BANDS, se devuelve la banda global de todo el dispositivo.

BandStart y BandSize no son válidos a menos que sus valores, en bytes, sean múltiplos exactos del tamaño de sector del dispositivo de almacenamiento subyacente.