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
この関数が作成するリソース リスト オブジェクトへの出力ポインター。 このパラメーターは、関数が IResourceList オブジェクトへのポインターを出力する呼び出し元によって割り当てられたポインター変数を指します。 このパラメーターに有効な、以外の NULL ポインター値を指定します。
[in, optional] OuterUnknown
IUnknown オブジェクトを集計する必要があるオブジェクトのインターフェイスへのポインター。 集計が必要な場合を除き、このパラメーターを NULL 設定します。
[in] PoolType
オブジェクトの割り当て元となるプールの種類を指定します。 これは POOL_TYPE 列挙値です。
[in] ParentList
子リストの作成元となるリソース リストへのポインター。 リソース リストには、IResourceList インターフェイス があります。
[in] MaximumEntries
リソース リストに追加されるエントリの最大数を指定します。
戻り値
PcNewResourceSublist は、呼び出しが成功した場合にSTATUS_SUCCESSを返します。 それ以外の場合は、適切なエラー コードが返されます。
備考
この関数は、空のリソース サブリストを作成します。
アダプター ドライバーは通常、PcNewResourceSublist 関数を IResourceList::AddEntryFromParent メソッドと組み合わせて使用して、システムから受信したリソースの元のリストを取得し、さまざまなサブデバイスに割り当てるサブリストに分割します。
OutResourceList、outerUnknown 、および parentList パラメーター、COM オブジェクトの の参照カウント規則に従います。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | PortCls システム ドライバーは、Microsoft Windows 98/Me および Windows 2000 以降のオペレーティング システムで PcNewResourceSublist 関数を実装します。 |
| ターゲット プラットフォーム の | 万国 |
| ヘッダー | portcls.h (Portcls.h を含む) |
| ライブラリ | Portcls.lib |
| IRQL | PASSIVE_LEVEL |
関連項目
IResourceList の