WdfIoResourceRequirementsListAppendIoResList 関数 (wdfresource.h)
[KMDF にのみ適用]
WdfIoResourceRequirementsListAppendIoResList メソッドは、リソース要件リストの末尾に論理構成を追加します。
構文
NTSTATUS WdfIoResourceRequirementsListAppendIoResList(
[in] WDFIORESREQLIST RequirementsList,
[in] WDFIORESLIST IoResList
);
パラメーター
[in] RequirementsList
デバイスのリソース要件リストを表すフレームワーク resource-requirements-list オブジェクトへのハンドル。
[in] IoResList
デバイスのハードウェア リソースの論理構成を表すフレームワーク リソース範囲リスト オブジェクトへのハンドル。
戻り値
操作が成功した場合、WdfIoResourceRequirementsListAppendIoResList はSTATUS_SUCCESSを返します。 それ以外の場合、このメソッドは次のいずれかの値を返す可能性があります。
リターン コード | 説明 |
---|---|
|
無効なパラメーターが指定されました。 |
|
指定した resource-requirements-list オブジェクトは、指定された resource-range-list オブジェクトを所有していません。 |
|
フレームワークは、resource-range-list オブジェクトを格納する領域を割り当てませんでした。 |
ドライバーが無効なオブジェクト ハンドルを提供すると、システム バグ チェックが発生します。
注釈
リソース要件リストの詳細については、「 Framework-Based ドライバーのハードウェア リソース」を参照してください。
例
次のコード例は、 EvtDeviceResourceRequirementsQuery コールバック関数が空の論理構成を作成し、それをリソース要件リストに追加する方法を示しています。
NTSTATUS
Example_EvtDeviceResourceRequirementsQuery(
IN WDFDEVICE Device,
IN WDFIORESREQLIST RequirementsList
)
{
NTSTATUS status;
WDFIORESLIST logConfig;
status = WdfIoResourceListCreate(
RequirementsList,
WDF_NO_OBJECT_ATTRIBUTES,
&logConfig
);
if (!NT_SUCCESS(status)) {
return status;
}
status = WdfIoResourceRequirementsListAppendIoResList(
RequirementsList,
logConfig
);
if (!NT_SUCCESS(status)) {
return status;
}
...
}
要件
要件 | 値 |
---|---|
対象プラットフォーム | ユニバーサル |
最小 KMDF バージョン | 1.0 |
Header | wdfresource.h (Wdf.h を含む) |
Library | Wdf01000.sys (「Framework ライブラリのバージョン管理」を参照)。 |
IRQL | <=DISPATCH_LEVEL |
DDI コンプライアンス規則 | DriverCreate(kmdf)、 KmdfIrql(kmdf)、 KmdfIrql2(kmdf)、KmdfIrqlExplicit(kmdf) |