PcNewResourceSublist 関数 (portcls.h)

PcNewResourceSublist 関数は、別のリソース リストから派生した空のリソース リストを作成して初期化します。

構文

PORTCLASSAPI NTSTATUS PcNewResourceSublist(
  [out]          PRESOURCELIST *OutResourceList,
  [in, optional] PUNKNOWN      OuterUnknown,
  [in]           POOL_TYPE     PoolType,
  [in]           PRESOURCELIST ParentList,
  [in]           ULONG         MaximumEntries
);

パラメーター

[out] OutResourceList

この関数が作成する resource-list オブジェクトへの出力ポインター。 このパラメーターは、関数が IResourceList オブジェクトへのポインターを出力する呼び出し元によって割り当てられたポインター変数を指します。 このパラメーターに有効な NULL 以外のポインター値を指定します。

[in, optional] OuterUnknown

オブジェクトを集計する必要があるオブジェクトの IUnknown インターフェイスへのポインター。 集計が必要な場合を除き、このパラメーターを NULL に設定 します。

[in] PoolType

オブジェクトの割り当て元となるプールの種類を指定します。 これは 、POOL_TYPE 列挙値です。

[in] ParentList

子リストの作成元となるリソース リストへのポインター。 リソース リストには IResourceList インターフェイスがあります。

[in] MaximumEntries

リソース リストに追加されるエントリの最大数を指定します。

戻り値

PcNewResourceSublist は、呼び出しが成功した場合にSTATUS_SUCCESSを返します。 それ以外の場合は、適切なエラー コードを返します。

注釈

この関数は、空のリソース サブリストを作成します。

アダプター ドライバーは通常、IResourceList::AddEntryFromParent メソッドと組み合わせて PcNewResourceSublist 関数を使用して、システムから受信したリソースの元のリストを取得し、それらをさまざまなサブデバイスに割り当てるサブリストに分割します。

OutResourceList、OuterUnknown、ParentList の各パラメーターは、COM オブジェクトの参照カウント規則に従います。

要件

こちらもご覧ください

IResourceList

IResourceList::AddEntryFromParent

POOL_TYPE