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

こちらもご覧ください

CM_RESOURCE_LIST

IResourceList

POOL_TYPE