Поделиться через

код элемента управления FSCTL_SET_REFS_SMR_VOLUME_GC_PARAMETERS

  • Статья

Код элемента управления FSCTL_SET_REFS_SMR_VOLUME_GC_PARAMETERS управляет сборкой мусора на томе shingled Magnetic Recording (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

Параметры

  • hDevice [in]: дескриптор устройства. Чтобы получить дескриптор устройства, вызовите функцию CreateFile .

  • dwIoControlCode [in]: код элемента управления для операции. Используйте FSCTL_SET_REFS_SMR_VOLUME_GC_PARAMETERS для этой операции.

  • lpInBuffer [in]: указатель на структуру, выделенную вызывающим объектом REFS_SMR_VOLUME_GC_PARAMETERS .

  • nInBufferSize [in]: размер входного буфера в байтах.

  • lpOutBuffer [out]: не используется с этой операцией; для параметра задано значение NULL.

  • nOutBufferSize [in]: не используется с этой операцией; Значение равно нулю.

  • lpBytesReturned [out]: не используется в этой операции; для параметра задано значение NULL.

  • lpOverlapped [in]: указатель на структуру OVERLAPPED .

    Если hDevice был открыт без указания FILE_FLAG_OVERLAPPED, lpOverlapped игнорируется.

    Если hDevice был открыт с флагом FILE_FLAG_OVERLAPPED , операция выполняется как перекрываемая (асинхронная) операция. В этом случае lpOverlapped должен указывать на допустимую структуру OVERLAPPED , содержащую дескриптор объекта события. В противном случае функция завершается сбоем непредсказуемым образом.

    Для перекрывающихся операций DeviceIoControl возвращает немедленно, и объект события получает сигнал о завершении операции. В противном случае функция не возвращается, пока операция не будет завершена или не возникнет ошибка.

Возвращаемое значение

Если операция завершается успешно, DeviceIoControl возвращает ненулевое значение.

Если операция завершается сбоем или находится в состоянии ожидания, DeviceIoControl возвращает ноль. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Требования

Тип требования Требование
Минимальная версия клиента Windows 10 версии 1709
Заголовок WinIoctl.h

См. также раздел

DeviceIoControl