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]: この操作では使用されません。0 に設定します。

• lpBytesReturned [out]: この操作では使用されません。NULL に設定します。

• lpOverlapped [in]: OVERLAPPED 構造体へのポインター。

  FILE_FLAG_OVERLAPPED を指定しないで hDevice が開かれた場合、lpOverlapped は無視されます。

  hDevice が FILE_FLAG_OVERLAPPED フラグを指定して開かれた場合、操作は重複した (非同期) 操作として実行されます。 この場合、lpOverlapped は、イベント オブジェクトへのハンドルを含む有効な OVERLAPPED 構造体を指し示す必要があります。 そうでない場合、関数は予期しない方法で失敗します。

  重複する操作の場合は、DeviceIoControl が即座に返され、操作が完了するとイベント オブジェクトが通知されます。 それ以外の場合、操作が完了するかエラーが発生するまで関数は戻りません。

戻り値

操作が正常に完了すると、DeviceIoControl は 0 以外の値を返します。

操作が失敗したか保留中の場合、DeviceIoControl は 0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。

要件

関連項目

DeviceIoControl