UrsIoResourceListAppendDescriptor 関数 (ursdevice.h)

指定したリソース記述子を、ホストまたは関数ロールのリソース記述子を保持する指定された I/O リソース リスト オブジェクトに追加します。

構文

NTSTATUS UrsIoResourceListAppendDescriptor(
  [in] URSIORESLIST            IoResourceList,
  [in] PIO_RESOURCE_DESCRIPTOR Descriptor
);

パラメーター

[in] IoResourceList

リソース記述子が追加されるロールの I/O リソース リスト オブジェクト。 このオブジェクトはフレームワークによって割り当てられ、フレームワークがドライバーのEVT_URS_DEVICE_FILTER_RESOURCE_REQUIREMENTS実装を呼び出すときにクライアント ドライバー に 渡されます。

[in] Descriptor

ロールのリソース記述子を含むIO_RESOURCE_DESCRIPTORへのポインター。

戻り値

メソッドは、操作が成功した場合にSTATUS_SUCCESSを返します。 それ以外の場合、このメソッドは適切な NTSTATUS エラー コードを返す可能性があります。

注釈

クライアント ドライバーが UrsDeviceInitialize を呼び出した後、フレームワークは リソース要件リストにメモリを割り当てます。 USB デュアル ロール クラス拡張機能は、クライアント ドライバーのEVT_URS_DEVICE_FILTER_RESOURCE_REQUIREMENTSの実装 を呼び出すと、WDFIORESREQLIST ハンドルを、ホストおよび関数ロール リソース リストの URSIORESLIST ハンドルと共に、その要件リストに渡 します。 実装では、クライアント ドライバーは要件リストを列挙し、リソース記述子 (そのリソースを使用する場合) を各ロールのリソース 一覧に追加することが期待されます。

ロールのリソース記述子を追加するために、ドライバーは UrsIoResourceListAppendDescriptor を 呼び出し、リソースを追加する必要がある記述子とリソース リストを指定します。

コード例については、「 EVT_URS_DEVICE_FILTER_RESOURCE_REQUIREMENTS」を参照してください。

リソース要件の一覧の詳細については、「 ハードウェア リソースの処理」を参照してください。

要件

こちらもご覧ください

EVT_URS_DEVICE_FILTER_RESOURCE_REQUIREMENTS

UrsDeviceInitialize