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 オブジェクトの参照カウント規則に従います。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | PortCls システム ドライバーは、Microsoft Windows 98/Me および Windows 2000 以降のオペレーティング システムで PcNewResourceSublist 関数を実装します。 |
| 対象プラットフォーム | ユニバーサル |
| Header | portcls.h (Portcls.h を含む) |
| Library | Portcls.lib |
| IRQL | PASSIVE_LEVEL |