[KMDF にのみ適用]
WdfIoResourceListCreate メソッドは、空の 論理構成を作成します。これは、リソース要件リストに設定して追加できます。
構文
NTSTATUS WdfIoResourceListCreate(
[in] WDFIORESREQLIST RequirementsList,
[in, optional] PWDF_OBJECT_ATTRIBUTES Attributes,
[out] WDFIORESLIST *ResourceList
);
パラメーター
[in] RequirementsList
デバイスのリソース要件リストを表すフレームワーク リソース要件リスト オブジェクトへのハンドル。
[in, optional] Attributes
新しいオブジェクトの属性を含む呼び出し元によって割り当てられた WDF_OBJECT_ATTRIBUTES 構造体へのポインター。 (構造体の ParentObject メンバーは NULL する必要があります)。このパラメーターは省略可能であり、WDF_NO_OBJECT_ATTRIBUTESできます。
[out] ResourceList
新しい論理構成を表すフレームワーク リソース範囲リスト オブジェクトへのハンドル。
戻り値
WdfIoResourceListCreate 、操作が成功した場合にSTATUS_SUCCESSを返します。
その他の戻り値については、「Framework オブジェクト作成エラーの」を参照してください。
ドライバーが無効なオブジェクト ハンドルを提供すると、システム バグ チェックが発生します。
備考
リソース要件リストと論理構成の詳細については、「Framework-Based ドライバー のハードウェア リソースの」を参照してください。
呼び出し元が指定した resource-requirements-list オブジェクトは、新しい resource-range-list オブジェクトの親になります。 ドライバーはこの親を変更できません。また、ParentObject メンバーまたは WDF_OBJECT_ATTRIBUTES 構造体は NULL する必要があります。
例
WdfIoResourceListCreate 使用するコード例については、「WdfIoResourceRequirementsListAppendIoResListを参照してください。
必要条件
要件 | 価値 |
---|---|
ターゲット プラットフォーム の | 万国 |
最小 KMDF バージョン | 1.0 |
ヘッダー | wdfresource.h (Wdf.h を含む) |
ライブラリ | Wdf01000.sys (フレームワーク ライブラリのバージョン管理を参照)。 |
IRQL | <=DISPATCH_LEVEL |
DDI コンプライアンス規則 を する | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |