コントロール コードIOCTL_VOLUME_IS_CSVする

  • [アーティクル]

ボリュームが CSV ボリュームであるかどうかを判断します。

この操作を実行するには、次のパラメーターを使用して DeviceIoControl 関数を呼び出します。

BOOL 
WINAPI 
DeviceIoControl( (HANDLE) hDevice,              // handle to device
                 IOCTL_VOLUME_IS_CSV,           // dwIoControlCode
                 NULL,                          // input buffer
                 0,                             // size of input buffer
                 (LPVOID) lpOutBuffer,          // lpOutBuffer
                 (DWORD) nOutBufferSize,        // nOutBufferSize
                 (LPDWORD) lpBytesReturned,     // number of bytes returned
                 (LPOVERLAPPED) lpOverlapped ); // OVERLAPPED structure

パラメーター

hDevice

ボリュームへのハンドル。 ボリューム ハンドルを取得するには、 CreateFile 関数を呼び出します。 ボリューム ハンドルを開くことができるのは管理者だけです。

dwIoControlCode

操作の制御コード。 この操作 にはIOCTL_VOLUME_IS_CSV を使用します。

lpInBuffer

この操作では使用されません。 を NULL に設定します。

nInBufferSize

この操作では使用されません。をゼロ (0) に設定します。

lpOutBuffer

ボリュームが CSV ボリュームの場合は TRUE へのポインター。それ以外の場合、関数呼び出しは失敗します。

nOutBufferSize

出力バッファーのサイズ (バイト単位)。

lpBytesReturned

出力バッファーに格納されているデータのサイズをバイト単位で受け取る変数へのポインター。

lpOverlapped が NULL の場合、lpBytesReturned を NULL にすることはできません。 操作で出力データが返されず、 lpOutBuffer が NULL の場合でも、 DeviceIoControl は lpBytesReturned を使用します。 このような操作の後、 lpBytesReturned の値は意味がありません。

lpOverlapped が NULL でない場合、lpBytesReturned には NULL を指定できます。 このパラメーターが NULL ではなく、操作がデータを返す場合、重複する操作が完了するまで lpBytesReturned は意味がありません。 返されたバイト数を取得するには、 GetOverlappedResult を呼び出します。 hDevice が I/O 完了ポートに関連付けられている場合は、GetQueuedCompletionStatus を呼び出して返されるバイト数を取得できます。

lpOverlapped

OVERLAPPED 構造体へのポインター。

FILE_FLAG_OVERLAPPEDを指定せずに hDevice を開いた場合、lpOverlapped は無視されます。

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

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

戻り値

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

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

必要条件

要件 値
サポートされている最小のクライアント
 サポートなし
サポートされている最小のサーバー
 Windows Server 2012 [デスクトップ アプリのみ]
Header
Ntddvol.h

関連項目

CreateFile

DeviceIoControl

ボリューム管理の制御コード