Compartilhar via


IOCTL_STORAGE_QUERY_PROPERTY IOCTL (winioctl.h)

Os aplicativos do Windows podem usar esse código de controle para retornar as propriedades de um dispositivo de armazenamento ou adaptador. A solicitação indica o tipo de informação a ser recuperada, como dados de consulta para um dispositivo ou recursos e limitações de um adaptador. IOCTL_STORAGE_QUERY_PROPERTY também pode ser usado para determinar se o driver de porta dá suporte a uma propriedade específica ou quais campos no descritor de propriedade podem ser modificados com uma solicitação de propriedade de alteração subsequente.

BOOL DeviceIoControl(
     _In_        (HANDLE)       hDevice,                // handle to a partition
     _In_        (DWORD) IOCTL_STORAGE_QUERY_PROPERTY,  // dwIoControlCode
     _In_        (LPVOID)       lpInBuffer,             // input buffer - STORAGE_PROPERTY_QUERY structure
     _In_        (DWORD)        nInBufferSize,          // size of input buffer
     _Out_opt_   (LPVOID)       lpOutBuffer,            // output buffer - see Remarks
     _In_        (DWORD)        nOutBufferSize,         // size of output buffer
     _Out_opt_   (LPDWORD)      lpBytesReturned,        // number of bytes returned
     _Inout_opt_ (LPOVERLAPPED) lpOverlapped            // OVERLAPPED structure
);

Comentários

O buffer de saída opcional retornado por meio do parâmetro lpOutBuffer pode ser uma das várias estruturas, dependendo do valor do membro PropertyId da estrutura STORAGE_PROPERTY_QUERY apontada pelo parâmetro lpInBuffer . Esses valores são enumerados pela enumeração STORAGE_PROPERTY_ID . Se o membro QueryType do STORAGE_PROPERTY_QUERY estiver definido como PropertyExistsQuery , nenhuma estrutura será retornada.

Requisitos

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

Confira também