WdfIoResourceListCreate 関数 (wdfresource.h)
[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 |
| Header | wdfresource.h (Wdf.h を含む) |
| Library | Wdf01000.sys (「Framework ライブラリのバージョン管理」を参照)。 |
| IRQL | <=DISPATCH_LEVEL |
| DDI コンプライアンス規則 | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |