PcNewResourceList 関数 (portcls.h)
PcNewResourceList 関数は、リソース リストを作成して初期化します。
構文
PORTCLASSAPI NTSTATUS PcNewResourceList(
[out] PRESOURCELIST *OutResourceList,
[in, optional] PUNKNOWN OuterUnknown,
[in] POOL_TYPE PoolType,
[in] PCM_RESOURCE_LIST TranslatedResources,
[in] PCM_RESOURCE_LIST UntranslatedResources
);
パラメーター
[out] OutResourceList
この関数によって作成された resource-list オブジェクトの出力ポインター。 このパラメーターは、関数が IResourceList オブジェクトへのポインターを出力する呼び出し元によって割り当てられたポインター変数を指します。 このパラメーターに有効な NULL 以外のポインター値を指定します。
[in, optional] OuterUnknown
resource-list オブジェクトを集計する必要があるオブジェクトの IUnknown インターフェイスへのポインター。 集計が必要な場合を除き、このパラメーターを NULL に設定 します。
[in] PoolType
オブジェクトの割り当て元となるプールの種類を指定します。 これは 、POOL_TYPE 列挙値です。
[in] TranslatedResources
翻訳されたリソースの WDM 提供のリソース リストへのポインター。 リストは、 CM_RESOURCE_LIST型のシステム構造です。
[in] UntranslatedResources
変換されていないリソースの WDM 提供のリソース リストへのポインター。 リストは、 CM_RESOURCE_LIST型のシステム構造です。
戻り値
PcNewResourceList は、呼び出しが成功した場合にSTATUS_SUCCESSを返します。 それ以外の場合は、適切なエラー コードを返します。
注釈
翻訳済みリソースリストと未翻訳リソースリストの詳細については、「 仮想アドレスへの Bus-Relative アドレスのマッピング」を参照してください。
OutResourceList パラメーターと OuterUnknown パラメーターは、COM オブジェクトの参照カウント規則に従います。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | PortCls システム ドライバーは、Microsoft Windows 98/Me および Windows 2000 以降のオペレーティング システムで PcNewResourceList 関数を実装します。 |
| 対象プラットフォーム | ユニバーサル |
| Header | portcls.h (Portcls.h を含む) |
| Library | Portcls.lib |
| IRQL | PASSIVE_LEVEL |