IOCTL_STORAGE_SET_PROPERTY IOCTL (ntddstor.h)

  • Artigo

Um driver pode usar IOCTL_STORAGE_SET_PROPERTY para definir as propriedades de um dispositivo de armazenamento ou adaptador.

Observação

Devido à colisão de definições de IOCTL no Windows 10 versão 2004, o software existente que usa IOCTL_STORAGE_SET_PROPERTY precisará ser recompilado no Windows Server 2022.

Código principal

IRP_MJ_DEVICE_CONTROL

Buffer de entrada

Contém uma estrutura STORAGE_PROPERTY_SET que descreve o tipo de conjunto que está sendo feito, a propriedade que está sendo definida e quaisquer parâmetros adicionais exigidos por um conjunto de propriedades específico. Uma estrutura com propriedades adicionais pode ser encontrada imediatamente após a estrutura STORAGE_PROPERTY_SET, dependendo da PropertyId do STORAGE_PROPERTY_SET. Por exemplo, se PropertyId for StorageAdapterProtocolSpecificProperty, uma estrutura STORAGE_PROTOCOL_SPECIFIC_DATA_EXT imediatamente seguirá STORAGE_PROPERTY_SET.

Comprimento do buffer de entrada

Parameters.DeviceIoControl.InputBufferLength indica o tamanho, em bytes, do buffer de parâmetro em Irp-AssociatedIrp.SystemBuffer>, que deve ser >= sizeof(STORAGE_PROPERTY_SET).

Buffer de saída

Depende da PropertyId especificada. Por exemplo, se PropertyId for StorageAdapterProtocolSpecificProperty, o buffer de saída conterá uma estrutura STORAGE_PROTOCOL_SPECIFIC_DATA_EXT com dados atualizados do miniporto.

Comprimento do buffer de saída

Tamanho, em bytes, do buffer de saída.

Buffer de entrada/saída

n/d

Comprimento do buffer de entrada/saída

n/d

Bloco de status

Irp-IoStatus.Status será definido como STATUS_SUCCESS se a solicitação for bem-sucedida>. Caso contrário, Status para a condição de erro apropriada como um código NTSTATUS. Para obter mais informações, consulte Valores NTSTATUS.

Requisitos

Requisito Valor
Cabeçalho ntddstor.h

Confira também

STORAGE_PROPERTY_SET

STORAGE_PROTOCOL_SPECIFIC_DATA_EXT

STORAGE_SET_TYPE