Partager via

code de contrôle FSCTL_SET_REFS_SMR_VOLUME_GC_PARAMETERS

  • Article

Le code de contrôle FSCTL_SET_REFS_SMR_VOLUME_GC_PARAMETERS contrôle le garbage collection sur 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

Paramètres

  • hDevice [in] : handle pour l’appareil. Pour obtenir un handle d’appareil, appelez la fonction CreateFile .

  • dwIoControlCode [in] : code de contrôle pour l’opération. Utilisez FSCTL_SET_REFS_SMR_VOLUME_GC_PARAMETERS pour cette opération.

  • lpInBuffer [in] : pointeur vers une structure de REFS_SMR_VOLUME_GC_PARAMETERS allouée par l’appelant.

  • nInBufferSize [in] : taille de la mémoire tampon d’entrée, en octets.

  • lpOutBuffer [out] : non utilisé avec cette opération ; défini sur NULL.

  • nOutBufferSize [in] : non utilisé avec cette opération ; défini sur zéro.

  • lpBytesReturned [out] : non utilisé avec cette opération ; défini sur NULL.

  • lpOverlapped [in] : pointeur vers une structure CHEVAUCHEMENT .

    Si hDevice a été ouvert sans spécifier FILE_FLAG_OVERLAPPED, lpOverlapped est ignoré.

    Si hDevice a été ouvert avec l’indicateur FILE_FLAG_OVERLAPPED, l’opération est effectuée en tant qu’opération superposée (asynchrone). Dans ce cas, lpOverlapped doit pointer vers une structure OVERLAPPED valide qui contient le descripteur d’un objet d’événement. Sinon, la fonction échoue de façon imprévisible.

    Pour les opérations superposées, DeviceIoControl est immédiatement retourné, et l’objet d’événement est signalé une fois l’opération terminée. Sinon, la fonction n’est pas retournée tant que l’opération n’est pas terminée ou si une erreur se produit.

Valeur retournée

Si l’opération se termine correctement, DeviceIoControl retourne une valeur différente de zéro.

Si l’opération échoue ou est en attente, DeviceIoControl retourne zéro (0). Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Configuration requise

Type d’exigence Condition requise
Client minimal pris en charge Windows 10, version 1709
En-tête WinIoctl.h

Voir aussi

DeviceIoControl