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

  • [アーティクル]

メソッドは FindTranslatedEntry 、指定された型の変換されたエントリへのポインターを返します。そのようなエントリが見つからない場合は NULL を 返します。

構文

PCM_PARTIAL_RESOURCE_DESCRIPTOR FindTranslatedEntry(
  [in] CM_RESOURCE_TYPE Type,
  [in] ULONG            Index
);

パラメーター

[in] Type

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

[in] Index

検索するエントリのインデックスを指定します。 IResourceList::NumberOfEntriesOfType メソッドが Type 型のエントリ数の値 n を返す場合、有効なインデックスの範囲は 0 から n-1 です。 たとえば、 Index が 0 の場合、メソッドは、リソース リストから指定した型のエントリが最初に出現した翻訳されたバージョンへのポインターを返します。

戻り値

FindTranslatedEntry は、指定されたエントリへのポインターを返します。エントリが存在しない場合は NULL です 。 このポインターは、リソース リスト オブジェクトが削除されるまで有効なままです。

注釈

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

Index パラメーターは、翻訳されたリソース エントリの一覧で検索する、指定した型のエントリの出現を示します。 リスト内で最初に出現するインデックスは 0 です。

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

翻訳済みリソースと未翻訳リソース (または "生" リソース) の詳細については、「 CM_PARTIAL_RESOURCE_DESCRIPTOR」を参照してください。

要件

要件 値
対象プラットフォーム ユニバーサル
Header portcls.h (Portcls.h を含む)
IRQL PASSIVE_LEVEL

こちらもご覧ください

CM_PARTIAL_RESOURCE_DESCRIPTOR

IResourceList

IResourceList::FindUntranslatedEntry

IResourceList::NumberOfEntriesOfType