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

[アーティクル]
02/29/2024

メソッドは 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	エントリが親リストに見つからなかった場合を示します。