WdfIoResourceRequirementsListAppendIoResList 関数 (wdfresource.h)

[KMDF にのみ適用]

WdfIoResourceRequirementsListAppendIoResList メソッドは、リソース要件リストの末尾に論理構成を追加します。

構文

NTSTATUS WdfIoResourceRequirementsListAppendIoResList(
  [in] WDFIORESREQLIST RequirementsList,
  [in] WDFIORESLIST    IoResList
);

パラメーター

[in] RequirementsList

デバイスのリソース要件リストを表すフレームワーク resource-requirements-list オブジェクトへのハンドル。

[in] IoResList

デバイスのハードウェア リソースの論理構成を表すフレームワーク リソース範囲リスト オブジェクトへのハンドル。

戻り値

操作が成功した場合、WdfIoResourceRequirementsListAppendIoResList はSTATUS_SUCCESSを返します。 それ以外の場合、このメソッドは次のいずれかの値を返す可能性があります。

ドライバーが無効なオブジェクト ハンドルを提供すると、システム バグ チェックが発生します。

注釈

リソース要件リストの詳細については、「 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;
    }
...
}

要件

こちらもご覧ください

WdfIoResourceListCreate

WdfIoResourceRequirementsListInsertIoResList