код элемента управления 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 |