FSCTL_ALLOW_EXTENDED_DASD_IO IOCTL (winioctl.h)

[アーティクル]
08/27/2023

パーティションの読み取りまたは書き込みの呼び出しに対して I/O 境界チェックを実行しないように、ファイルシステムドライバーに通知します。代わりに、境界チェックはデバイスドライバーによって実行されます。

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

C++
BOOL DeviceIoControl( (HANDLE) hDevice, // handle to device FSCTL_ALLOW_EXTENDED_DASD_IO, // dwIoControlCodeNULL, // lpInBuffer0, // nInBufferSizeNULL, // lpOutBuffer0, // nOutBufferSize(LPDWORD) lpBytesReturned, // number of bytes returned (LPOVERLAPPED) lpOverlapped // OVERLAPPED structure );

C++

BOOL DeviceIoControl(
  (HANDLE) hDevice,              // handle to device
  FSCTL_ALLOW_EXTENDED_DASD_IO,  // dwIoControlCodeNULL,                          // lpInBuffer0,                             // nInBufferSizeNULL,                          // lpOutBuffer0,                             // nOutBufferSize(LPDWORD) lpBytesReturned,     // number of bytes returned
  (LPOVERLAPPED) lpOverlapped    // OVERLAPPED structure
);

注釈

FSCTL_ALLOW_EXTENDED_DASD_IO制御コードを使用する呼び出しは、ハードディスクドライブとファイルシステムの基になる構造に精通しているプログラマが慎重に使用する必要があります。パーティションに対する後続の書き込み操作の不適切な使用や不正確なチェックにより、パーティション上のデータが破損したり、パーティション全体が破壊されたりする可能性があります。

FSCTL_ALLOW_EXTENDED_DASD_IOコントロールコードは、指定されたハンドルで行われた読み取りまたは書き込み呼び出しで I/O 境界チェックを実行しないようにファイルシステムドライバーに通知するために使用されます。 FSCTL_ALLOW_EXTENDED_DASD_IO では、パーティションの最初のセクター (ブートパラメーターブロック) とパーティションの最初の有用なセクターの間に存在する可能性があるパーティションの一部である非表示セクターにアクセスできます。 FSCTL_ALLOW_EXTENDED_DASD_IO では、最後に役立つクラスターとパーティションの末尾の間に存在する可能性がある、失われたクラスターへのアクセスも許可されます。

この操作の後に発行された I/O 要求は、デバイスドライバーに直接渡されます。これらの後続の呼び出しでパーティション境界を超える要求データが呼び出されると、ドライバーによってエラーが発生します。

この操作に対する重複した I/O の影響については、 DeviceIoControl の「解説」セクションを参照してください。

パーティションへのハンドルを取得するには、 lpFileName パラメーターを次の形式の文字列に設定して CreateFile を呼び出します。

\.\X:

ここで、X はドライブ文字です。

CreateFile を呼び出すアプリケーションでは、CreateFile の dwShareMode パラメーターにFILE_SHARE_READフラグとFILE_SHARE_WRITE フラグも指定する必要があります。詳細については、「 CreateFile」の「ディスクデバイス」セクションを参照してください。

ドライブのパーティション構造を決定し、システムがパーティションを認識するかどうかを判断するには、必要に応じて、IOCTL_DISK_GET_DRIVE_LAYOUT_EX または IOCTL_DISK_GET_DRIVE_LAYOUT 制御コードを使用します。 1 つのパーティションに関する同様の情報については、必要に応じて、IOCTL_DISK_GET_PARTITION_INFO_EX または IOCTL_DISK_GET_PARTITION_INFO 制御コードを使用します。クラスターのサイズを決定するには、必要に応じて GetDiskFreeSpaceEx または GetDiskFreeSpace 関数を使用します。

Windows Server 2012では、この関数は次のテクノロジでサポートされています。

テクノロジ	サポートされています
サーバーメッセージブロック (SMB) 3.0 プロトコル	いいえ
SMB 3.0 Transparent Failover (TFO)	いいえ
スケールアウトファイル共有 (SO) を使う SMB 3.0	いいえ
クラスターの共有ボリュームファイルシステム (CsvFS)	はい
Resilient File System (ReFS)	はい

必要条件

要件	値
サポートされている最小のクライアント	Windows XP (デスクトップアプリのみ)
サポートされている最小のサーバー	Windows Server 2003 (デスクトップアプリのみ)
Header	winioctl.h (Windows.h を含む)