共用方式為

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]： 重迭 結構的指標。

    如果 開啟 hDevice 而不指定 FILE_FLAG_OVERLAPPED，則會忽略 lpOverlapped 。

    如果 hDevice 是以 FILE_FLAG_OVERLAPPED 旗標開啟，則會以重疊的 (異步) 作業來執行。 在此情況下， lpOverlapped 必須指向包含事件物件句柄的有效 OVERLAPPED 結構。 否則，函式會以無法預期的方式失敗。

    針對重疊的作業， DeviceIoControl 會立即傳回，而且當作業完成時會發出事件對象的訊號。 否則，函式不會在作業完成或發生錯誤之前傳回。

傳回值

如果作業順利完成， DeviceIoControl 會傳回非零值。

如果作業失敗或擱置中， DeviceIoControl 會 傳回零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。

規格需求

需求類型 需求
最低支援的用戶端 Windows 10 (版本 1709)
標頭 WinIoctl.h

另請參閱

DeviceIoControl