codice di controllo FSCTL_SET_REFS_SMR_VOLUME_GC_PARAMETERS

  • Articolo

Il codice di controllo FSCTL_SET_REFS_SMR_VOLUME_GC_PARAMETERS controlla l'operazione di Garbage Collection in un volume SMR (Shingled Magnetic Recording).

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

Parametri

  • hDevice [in]: handle per il dispositivo. Per ottenere un handle di dispositivo, chiamare la funzione CreateFile .

  • dwIoControlCode [in]: codice di controllo per l'operazione. Usare FSCTL_SET_REFS_SMR_VOLUME_GC_PARAMETERS per questa operazione.

  • lpInBuffer [in]: puntatore a una struttura di REFS_SMR_VOLUME_GC_PARAMETERS allocata dal chiamante.

  • nInBufferSize [in]: dimensioni del buffer di input, in byte.

  • lpOutBuffer [out]: non usato con questa operazione; impostare su NULL.

  • nOutBufferSize [in]: non usato con questa operazione; impostato su zero.

  • lpBytesReturned [out]: non usato con questa operazione; impostare su NULL.

  • lpOverlapped [in]: puntatore a una struttura OVERLAPPED .

    Se hDevice è stato aperto senza specificare FILE_FLAG_OVERLAPPED, lpOverlapped viene ignorato.

    Se hDevice è stato aperto con il flag FILE_FLAG_OVERLAPPED , l'operazione viene eseguita come operazione sovrapposta (asincrona). In questo caso , lpOverlapped deve puntare a una struttura OVERLAPPED valida che contiene un handle a un oggetto evento. In caso contrario, la funzione ha esito negativo in modi imprevedibili.

    Per le operazioni sovrapposte, DeviceIoControl restituisce immediatamente e l'oggetto evento viene segnalato al termine dell'operazione. In caso contrario, la funzione non restituisce finché l'operazione non è stata completata o si verifica un errore.

Valore restituito

Se l'operazione viene completata correttamente, DeviceIoControl restituisce un valore diverso da zero.

Se l'operazione ha esito negativo o è in sospeso, DeviceIoControl restituisce zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Requisiti

Tipo di requisito Requisito
Client minimo supportato Windows 10, versione 1709
Intestazione WinIoctl.h

Vedi anche

Deviceiocontrol