FS_BPIO_RESULTS 構造体 (ntifs.h)

  • [アーティクル]

FS_BPIO_RESULTS構造体は、ドライバーが操作に失敗したときに、FS_BPIO_OP_ENABLEおよびFS_BPIO_OP_QUERY操作の BypassIO 操作固有の出力を定義します。

構文

typedef struct _FS_BPIO_RESULTS {
  NTSTATUS OpStatus;
  USHORT   FailingDriverNameLen;
  WCHAR    FailingDriverName[32];
  USHORT   FailureReasonLen;
  WCHAR    FailureReason[128];
} FS_BPIO_RESULTS, *PFS_BPIO_RESULTS;

メンバー

OpStatus

失敗したドライバーがこのファイルの BypassIO をサポートできない理由を識別する NTSTATUS コードを呼び出し元が受け取ります。 このフィールドは、有効/クエリ要求を失敗させるために、最初のドライバーによってのみ設定する必要があります。

FailingDriverNameLen

FailingDriverName に格納されている文字列の長さを文字数で受け取ります。

FailingDriverName[32]

要求に失敗したドライバーの名前を指定する文字列を受け取ります。 診断上の理由から、ドライバーは、FS_BPIO_OP_ENABLEまたはFS_BPIO_OP_QUERY操作に失敗したときに、その名前を格納する必要があります。 名前は、システムで使用されるドライバーの実際の名前と一致する必要があります。たとえば、 をntfs.sysします。 この文字列は NULL で終わる保証はありません。

FailureReasonLen

FailingReason に格納されている文字列の長さを文字数で受け取ります。

FailureReason[128]

ドライバーが有効/クエリ要求を拒否した理由を説明する一意の説明文字列を受け取ります。 この文字列は診断上の理由から使用され、ローカライズする必要がないように英語にする必要があります。 この文字列は NULL で終わる保証はありません。

注釈

ドライバー が BypassIO の有効化操作またはクエリ操作に失敗した場合、 FS_BPIO_RESULTSは FS_BPIO_OPERATIONS 構造体で返されます。

詳細については、「 フィルター ドライバーの BypassIO 」と 「BypassIO 操作のサポート 」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows 11
Header ntifs.h

こちらもご覧ください

FS_BPIO_OPERATIONS

FSCTL_MANAGE_BYPASS_IO