WDF_FILEOBJECT_CLASS列挙 (wdfdevice.h)

[KMDF と UMDF に適用]

WDF_FILEOBJECT_CLASS列挙は、ドライバーが、アプリケーションまたは別のドライバーが作成または開こうとしているファイルを表すためにフレームワーク ファイル オブジェクトを必要とするかどうかを識別する値を定義します。 これらの値は、フレームワークがオブジェクトのハンドルを格納できる場所も指定します。

構文

typedef enum _WDF_FILEOBJECT_CLASS {
  WdfFileObjectInvalid = 0,
  WdfFileObjectNotRequired = 1,
  WdfFileObjectWdfCanUseFsContext = 2,
  WdfFileObjectWdfCanUseFsContext2 = 3,
  WdfFileObjectWdfCannotUseFsContexts = 4,
  WdfFileObjectCanBeOptional = 0x80000000
} WDF_FILEOBJECT_CLASS, *PWDF_FILEOBJECT_CLASS;

定数

注釈

WDF_FILEOBJECT_CLASS列挙体は、WDF_FILEOBJECT_CONFIG構造体で使用されます。

ドライバーが WdfRequestGetFileObject を呼び出して I/O 要求のフレームワーク ファイル オブジェクトを取得し、ドライバーが受信する WDM I/O 要求パケット (IRP) の一部に WDM ファイル オブジェクトが含まれていないことがわかっている場合、ドライバーは WdfFileObjectCanBeOptional ビット フラグを設定できます。

ドライバーが WdfFileObjectWdfCanUseFsContext、WdfFileObjectWdfCanUseFsContext2、または WdfFileObjectWdfCannotUseFsContexts 値を設定し、WdfFileObjectCanBeOptional ビット フラグを設定していない場合、フレームワークの検証ツールは、ドライバーが WdfRequestGetFileObject メソッドを呼び出したときに、次の場合にエラーを報告します。

• IRP には WDM ファイル オブジェクトは含まれません。
• IRP には WDM ファイル オブジェクトが含まれていますが、ファイル オブジェクトは、ファイル作成 IRP が含まれているとは異なります。

要件

こちらもご覧ください

FILE_OBJECT

WDF_FILEOBJECT_CONFIG