Compartir a través de

FSCTL_SET_REFS_SMR_VOLUME_GC_PARAMETERS código de control

  • Artículo

El código de control FSCTL_SET_REFS_SMR_VOLUME_GC_PARAMETERS controla la recolección de elementos no utilizados en un volumen de grabación 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]: identificador del dispositivo. Para obtener un identificador de dispositivo, llame a la función CreateFile .

  • dwIoControlCode [in]: el código de control de la operación. Use FSCTL_SET_REFS_SMR_VOLUME_GC_PARAMETERS para esta operación.

  • lpInBuffer [in]: puntero a una estructura de REFS_SMR_VOLUME_GC_PARAMETERS asignada por el autor de la llamada.

  • nInBufferSize [in]: tamaño del búfer de entrada, en bytes.

  • lpOutBuffer [out]: No se usa con esta operación; se establece en NULL.

  • nOutBufferSize [in]: No se usa con esta operación; se establece en cero.

  • lpBytesReturned [out]: No se usa con esta operación; se establece en NULL.

  • lpOverlapped [in]: puntero a una estructura SUPERPUESTA .

    Si hDevice se abrió sin especificar FILE_FLAG_OVERLAPPED, se omite lpOverlapped.

    Si hDevice se abrió con la marca FILE_FLAG_OVERLAPPED, la operación se realiza como una operación superpuesta (asincrónica). En este caso, lpOverlapped debe apuntar a una estructura SUPERPUESTA válida que contenga un identificador para un objeto de evento. De lo contrario, se producirá un error en la función de formas impredecibles.

    En el caso de las operaciones superpuestas, se devuelve inmediatamente DeviceIoControl y se señala el objeto de evento cuando se ha completado la operación. De lo contrario, la función no se devuelve hasta que se haya completado la operación o hasta que se produzca un error.

Valor devuelto

Si la operación se completa correctamente, DeviceIoControl devuelve un valor distinto de cero.

Si se produce un error en la operación o está pendiente, DeviceIoControl devuelve cero. Para obtener información de error extendida, llame a GetLastError.

Requisitos

Tipo de requisito Requisito
Cliente mínimo compatible Windows 10, versión 1709
Encabezado WinIoctl.h

Consulte también

DeviceIoControl