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)

こちらもご覧ください

WDF_OBJECT_ATTRIBUTES

WDF_OBJECT_ATTRIBUTES_INIT

WdfDriverCreate

WdfObjectDelete