estrutura DEVICE_LB_PROVISIONING_DESCRIPTOR (winioctl.h)

  • Artigo

A estrutura DEVICE_LB_PROVISIONING_DESCRIPTOR é uma das estruturas de resultado da consulta retornadas de uma solicitação de IOCTL_STORAGE_QUERY_PROPERTY . Essa estrutura contém os recursos de provisionamento finos para um dispositivo de armazenamento.

Sintaxe

typedef struct _DEVICE_LB_PROVISIONING_DESCRIPTOR {
  DWORD     Version;
  DWORD     Size;
  BYTE      ThinProvisioningEnabled : 1;
  BYTE      ThinProvisioningReadZeros : 1;
  BYTE      AnchorSupported : 3;
  BYTE      UnmapGranularityAlignmentValid : 1;
  BYTE      GetFreeSpaceSupported : 1;
  BYTE      MapSupported : 1;
  BYTE      Reserved1[7];
  DWORDLONG OptimalUnmapGranularity;
  DWORDLONG UnmapGranularityAlignment;
  DWORD     MaxUnmapLbaCount;
  DWORD     MaxUnmapBlockDescriptorCount;
} DEVICE_LB_PROVISIONING_DESCRIPTOR, *PDEVICE_LB_PROVISIONING_DESCRIPTOR;

Membros

Version

Contém o tamanho dessa estrutura, em bytes. O valor desse membro será alterado à medida que os membros forem adicionados à estrutura.

Size

Especifica o tamanho total dos dados retornados, em bytes. Isso pode incluir dados que seguem essa estrutura.

ThinProvisioningEnabled

O status habilitado para provisionamento fino.

Valor Significado
0
 O provisionamento fino está desabilitado.
1
 O provisionamento fino está habilitado.

ThinProvisioningReadZeros

As leituras para regiões não mapeadas retornam zeros.

Valor Significado
0
 Os dados lidos de regiões não mapeadas são indefinidos.
1
 As leituras retornam zeros.

AnchorSupported

Suporte de leitura determinística após corte.

Valor Significado
0
 Não há suporte para leitura determinística após corte.
1
 Há suporte para leitura determinística após o corte.

UnmapGranularityAlignmentValid

A validade do alinhamento de granularidade não mapa para o dispositivo.

Valor Significado
0
 O alinhamento de granularidade não é válido.
1
 O alinhamento de granularidade não mapa é válido.

GetFreeSpaceSupported

MapSupported

Reserved1[7]

Reservado.

OptimalUnmapGranularity

O número ideal de setores lógicos para granularidade não mapa para o dispositivo.

UnmapGranularityAlignment

O valor atual, em setores lógicos, definido para alinhamento de granularidade não mapa no dispositivo.

MaxUnmapLbaCount

Começando em Windows 10: o número máximo de LBAs que podem ser não mapeados em um único comando unmap, em blocos lógicos.

MaxUnmapBlockDescriptorCount

Começando em Windows 10: o número máximo de descritores permitidos em um único comando unmap.

Comentários

Essa estrutura é retornada de uma solicitação de IOCTL_STORAGE_QUERY_PROPERTY quando o membro PropertyId de STORAGE_PROPERTY_QUERY é definido como StorageDeviceLBProvisioningProperty.

Se UnmapGranularityAlignmentValid = 0, qualquer código usando UnmapGranularityAlignment deverá assumir que ele tem um valor de 0.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2012 [somente aplicativos da área de trabalho]
Cabeçalho winioctl.h (inclua Windows.h)

Confira também

Estruturas do gerenciamento de disco

IOCTL_STORAGE_QUERY_PROPERTY

STORAGE_PROPERTY_QUERY