FSCTL_SET_REFS_SMR_VOLUME_GC_PARAMETERS código de controle

  • Artigo

O código de controle FSCTL_SET_REFS_SMR_VOLUME_GC_PARAMETERS controla a coleta de lixo em um volume de Gravação Magnética Shingled (SMR).

BOOL
   DeviceIoControl( (HANDLE)       hDevice,         // handle to volume
                    FSCTL_SET_REFS_SMR_VOLUME_GC_PARAMETERS, // dwIoControlCode
                    (LPDWORD)      lpInBuffer,      // input buffer
                    (DWORD)        nInBufferSize,   // size of input buffer
                     NULL,     // output buffer
                     0,  // size of output buffer
                    (LPDWORD)      lpBytesReturned, // number of bytes returned
                    (LPOVERLAPPED) lpOverlapped );  // OVERLAPPED structure

Parâmetros

  • hDevice [in]: um identificador para o dispositivo. Para obter um identificador de dispositivo, chame a função CreateFile .

  • dwIoControlCode [in]: o código de controle da operação. Use FSCTL_SET_REFS_SMR_VOLUME_GC_PARAMETERS para esta operação.

  • lpInBuffer [in]: um ponteiro para uma estrutura de REFS_SMR_VOLUME_GC_PARAMETERS alocada pelo chamador.

  • nInBufferSize [in]: o tamanho do buffer de entrada, em bytes.

  • lpOutBuffer [out]: não usado com esta operação; definido como NULL.

  • nOutBufferSize [in]: não usado com esta operação; definido como zero.

  • lpBytesReturned [out]: não usado com esta operação; definido como NULL.

  • lpOverlapped [in]: um ponteiro para uma estrutura OVERLAPPED .

    Se hDevice tiver sido aberto sem especificar FILE_FLAG_OVERLAPPED, lpOverlapped será ignorado.

    Se hDevice tiver sido aberto com o sinalizador FILE_FLAG_OVERLAPPED, a operação será executada como uma operação sobreposta (assíncrona). Nesse caso, lpOverlapped deve apontar para uma estrutura OVERLAPPED válida que contenha um identificador para um objeto de evento. Caso contrário, a função falhará de maneiras imprevisíveis.

    Em operações sobrepostas, DeviceIoControl retorna imediatamente e o objeto do evento é sinalizado quando a operação é concluída. Caso contrário, a função não será retornada até que a operação seja concluída ou ocorra um erro.

Valor retornado

Se a operação for concluída com êxito, DeviceIoControl retornará um valor diferente de zero.

Se a operação falhar ou estiver pendente, DeviceIoControl retornará zero. Para obter informações de erro estendidas, chame GetLastError.

Requisitos

Tipo de Requisito Requisito
Cliente mínimo com suporte Windows 10, versão 1709
parâmetro WinIoctl.h

Confira também

DeviceIoControl