次の方法で共有

IResourceList::AddEntryFromParent メソッド (portcls.h)

  • [アーティクル]

AddEntryFromParent メソッドは、リソース リストの親リストにあるエントリをリソース リストに追加します。

構文

NTSTATUS AddEntryFromParent(
  [in] IResourceList    *Parent,
  [in] CM_RESOURCE_TYPE Type,
  [in] ULONG            Index
);

パラメーター

[in] Parent

エントリの取得元のオブジェクト 、IResourceList 親へのポインター。

[in] Type

追加するエントリのリソースの種類を識別します。 有効なリソースの種類の値の一覧については、CM_PARTIAL_RESOURCE_DESCRIPTOR 構造体の Type メンバーの説明を参照してください。

[in] Index

追加するエントリの親リストのインデックスを指定します。 親の IResourceList::NumberOfEntriesOfType メソッドが、type 型のエントリ数 n を返す場合、有効なインデックスの範囲は 0 から n-1 です。 たとえば、Index が 0 の場合、メソッドは、指定した型のエントリの最初の出現箇所を親リストから追加します。

戻り値

AddEntryFromParent は、呼び出しが成功した場合にSTATUS_SUCCESSを返します。 それ以外の場合、メソッドは適切なエラー コードを返します。 次の表に、考えられる戻り状態コードの一部を示します。

リターン コード 形容
STATUS_INSUFFICIENT_RESOURCES
 リストに空きエントリがないことを示します。
STATUS_INVALID_PARAMETER
 エントリが親リストに見つからなかったことが示されます。

備考

リソースの種類ごとに、このメソッドを呼び出すマクロが定義されています。 IResourceList のを参照してください。

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

必要条件

要件 価値
ターゲット プラットフォーム の 万国
ヘッダー portcls.h (Portcls.h を含む)
IRQL PASSIVE_LEVEL

関連項目

CM_PARTIAL_RESOURCE_DESCRIPTOR

IResourceList の

IResourceList::NumberOfEntriesOfType