WdfObjectCreate 関数 (wdfobject.h)
[KMDF と UMDF に適用]
WdfObjectCreate メソッドは、一般的なフレームワーク オブジェクトを作成します。
構文
NTSTATUS WdfObjectCreate(
[in, optional] PWDF_OBJECT_ATTRIBUTES Attributes,
[out] WDFOBJECT *Object
);
パラメーター
[in, optional] Attributes
新しいオブジェクトのドライバー指定の属性を含む WDF_OBJECT_ATTRIBUTES 構造体へのポインター。 このパラメーターは省略可能であり、WDF_NO_OBJECT_ATTRIBUTESできます。
[out] Object
新しいフレームワーク オブジェクトへのハンドルを受け取る場所へのポインター。
戻り値
操作が成功した場合、WdfObjectCreate はSTATUS_SUCCESSを返します。 その他の戻り値の一覧については、「 フレームワーク オブジェクト作成エラー」を参照してください。
このメソッドは、他の NTSTATUS 値も返す場合があります。
注釈
既定では、新しい一般的なフレームワーク オブジェクトの親は 、WdfDriverCreate メソッドによって作成されたフレームワーク ドライバー オブジェクトです。 WDF_OBJECT_ATTRIBUTES構造体の ParentObject メンバーを使用して、別の親を指定できます。 フレームワークは、親オブジェクトを削除すると、一般オブジェクトを削除します。 ドライバーが既定の親を変更しない場合、ドライバーは、オブジェクトの使用が完了したときに一般的なオブジェクトを削除する必要があります。それ以外の場合、オブジェクトは I/O マネージャーがドライバーをアンロードするまで残ります。
WdfObjectCreate メソッドの詳細については、「General Framework オブジェクトの使用」を参照してください。
フレームワーク オブジェクト階層のクリーンアップ規則の詳細については、「 フレームワーク オブジェクトのライフ サイクル」を参照してください。
例
次のコード例では、WDF_OBJECT_ATTRIBUTES構造体を初期化し、一般的なフレームワーク オブジェクトを作成します。
WDF_OBJECT_ATTRIBUTES Attributes;
WDFOBJECT Object;
WDF_OBJECT_ATTRIBUTES_INIT(&Attributes);
status = WdfObjectCreate(
&Attributes,
&Object
);
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | ユニバーサル |
| 最小 KMDF バージョン | 1.0 |
| 最小 UMDF バージョン | 2.0 |
| Header | wdfobject.h (Wdf.h を含む) |
| Library | Wdf01000.sys (KMDF);WUDFx02000.dll (UMDF) |
| IRQL | <=DISPATCH_LEVEL |
| DDI コンプライアンス規則 | DriverCreate(kmdf)、 KmdfIrql(kmdf)、 KmdfIrql2(kmdf)、KmdfIrqlExplicit(kmdf) |