estructura DEVICE_DATA_SET_LB_PROVISIONING_STATE (winioctl.h)
Estructura de salida para la acción DeviceDsmAction_Allocation del código de control IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES .
Sintaxis
typedef struct _DEVICE_DATA_SET_LB_PROVISIONING_STATE {
DWORD Size;
DWORD Version;
DWORDLONG SlabSizeInBytes;
DWORD SlabOffsetDeltaInBytes;
DWORD SlabAllocationBitMapBitCount;
DWORD SlabAllocationBitMapLength;
DWORD SlabAllocationBitMap[ANYSIZE_ARRAY];
} DEVICE_DATA_SET_LB_PROVISIONING_STATE, *PDEVICE_DATA_SET_LB_PROVISIONING_STATE, DEVICE_DSM_ALLOCATION_OUTPUT, *PDEVICE_DSM_ALLOCATION_OUTPUT;
Miembros
Size
Tamaño de esta estructura, incluido el mapa de bits, en bytes.
Version
Versión de esta estructura.
SlabSizeInBytes
Tamaño de una lalaba, en bytes.
SlabOffsetDeltaInBytes
Si el intervalo especificado no está alineado con la optimalUnmapGranularity tal como se devuelve en DEVICE_LB_PROVISIONING_DESCRIPTOR estructura, los datos representados en SlabAllocationBitMap se desplazan del intervalo especificado por esta cantidad.
SlabAllocationBitMapBitCount
Número de bits relevantes en el mapa de bits.
SlabAllocationBitMapLength
Número de DWORDs en la matriz de mapa de bits.
SlabAllocationBitMap[ANYSIZE_ARRAY]
Mapa de bits de asignación que contiene un bit para cada lalaba. Si se establece un bit, se asigna el lote correspondiente. De lo contrario, si un bit está claro, el lalaba correspondiente no está asignada.
Comentarios
La información del estado de aprovisionamiento se devuelve cuando el miembro Action de la estructura de DEVICE_MANAGE_DATA_SET_ATTRIBUTES se establece en DeviceDsmAction_Allocation. El llamador debe incluir solo un intervalo de conjuntos de datos en el búfer del sistema en DataSetRangesOffset.
A cambio, el búfer del sistema contiene una estructura de DEVICE_MANAGE_DATA_SET_ATTRIBUTES_OUTPUT seguida de la estructura DEVICE_DATA_SET_LB_PROVISIONING_STATE . La estructura DEVICE_DATA_SET_LB_PROVISIONING_STATE comienza en un desplazamiento desde el principio del búfer del sistema especificado por OutputBlockOffset en DEVICE_MANAGE_DATA_SET_ATTRIBUTES_OUTPUT.
Cada bit del mapa de bits de asignación representa una asignación de lalaba dentro del intervalo de conjuntos de datos solicitado. Los bits se corresponden directamente con los lalabas del intervalo de conjuntos de datos. Esto significa que el bit 0 del mapa de bits marca la primera lote del intervalo. Se asigna un lote si el valor de bit = 1 y no se asigna si el valor de bit = 0.
El espacio para SlabAllocationBitMap debe asignarse en función del número de posibles lalabas del intervalo de conjuntos de datos solicitado. SlabAllocationBitMapLength del mapa de bits devuelto es (number_of_slabs / 32) + ((number_of_slabs MOD 32) > 0 ? 1 : 0).
El tamaño de lalaba viene determinado por el miembro OptimalUnmapGranularity de la estructura DEVICE_LB_PROVISIONING_DESCRIPTOR devuelta desde un código de control de IOCTL_STORAGE_QUERY_PROPERTY . La longitud del intervalo de conjunto de datos proporcionado debe ser un múltiplo de OptimalUnmapGranularity. Cuando la longitud del intervalo no es un múltiplo de OptimalUnmapGranularity, se reduce a ser un múltiplo.
Si el desplazamiento inicial del intervalo de conjuntos de datos no está alineado en un límite de lalaba, un múltiplo de OptimalUnmapGranularity, el desplazamiento se ajustará al siguiente límite. La diferencia entre el desplazamiento solicitado y el desplazamiento ajustado se devuelve en SlabOffsetDeltaInBytes.
Si el total de asignación de lalaba devuelto en SlabAllocationBitMapBitCount no es el esperado debido a los ajustes de longitud o alineación del intervalo de conjunto de datos, se puede enviar una solicitud adicional con un intervalo de conjuntos de datos modificado según los valores de SlabAllocationBitMapBitCount y SlabOffsetDeltaInBytes. El nuevo intervalo seleccionará correctamente las loslabas que quedan fuera del mapa de bits devuelto por la solicitud anterior.
Si el tamaño de lalaba solicitado es demasiado grande (por ejemplo, si es mayor que la longitud máxima de transferencia del HBA), el IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES puede producir un error con ERROR_INVALID_PARAMETER.
Requisitos
| Cliente mínimo compatible | Windows 8 |
| Servidor mínimo compatible | Windows Server 2012 |
| Encabezado | winioctl.h (incluya Windows.h) |
Consulte también
DEVICE_LB_PROVISIONING_DESCRIPTOR