estructura ENUMERATE_BANDS_PARAMETERS (ehstorbandmgmt.h)
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 |
|---|---|
|
Se devuelven todas las bandas. Cuando se establece esta marca, se omiten los miembros BandId, BandStart y BandSize . |
|
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.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible a partir de Windows 8 |
| Encabezado | ehstorbandmgmt.h (incluya EhStorBandMgmt.h) |