SetupDiGetActualModelsSectionA 関数 (setupapi.h)

  • [アーティクル]

SetupDiGetActualModelsSection 関数は、デバイス INF ファイルからデバイスをインストールするときに使用する適切な装飾 INF モデル セクションを取得します。

構文

WINSETUPAPI BOOL SetupDiGetActualModelsSectionA(
  [in]            PINFCONTEXT          Context,
  [in, optional]  PSP_ALTPLATFORM_INFO AlternatePlatformInfo,
  [out, optional] PSTR                 InfSectionWithExt,
  [in]            DWORD                InfSectionWithExtSize,
  [out, optional] PDWORD               RequiredSize,
                  PVOID                Reserved
);

パラメーター

[in] Context

INF ファイルの INF Manufacturer セクションで製造元識別子エントリを指定する INF ファイル コンテキストへのポインター。 manufacturer-identifier エントリは INF Models セクション名を指定し、必要に応じて Models セクション名に TargetOSVersion 装飾を指定します。 INF ファイルと INF ファイル コンテキストの詳細については、INF ファイルと INFCONTEXT 構造の使用に関するプラットフォーム SDK のトピックを参照してください。

[in, optional] AlternatePlatformInfo

Windows バージョンとプロセッサ アーキテクチャに関する情報を提供する SP_ALTPLATFORM_INFO 構造体へのポインター。 この構造体の cbSize メンバーは sizeof(SP_ALTPLATFORM_INFO_V2) に設定する必要があります。 このパラメーターは省略可能であり、 NULL に設定できます。

[out, optional] InfSectionWithExt

修飾された INF Models セクション名と NULL 終端記号を含む文字列を受け取るバッファーへのポインター。 AlternatePlatformInfo が指定されていない場合は、修飾された INF モデル セクション名が現在のプラットフォームに適用されます。それ以外の場合は、指定した代替プラットフォームに名前が適用されます。 このパラメーターは省略可能であり、 NULL に設定できます。 このパラメーターが NULL の場合、関数は TRUE を返し、修飾された Models セクション名と終端の NULL 文字を返すために必要なサイズ (文字数) に RequiredSize を設定します。

[in] InfSectionWithExtSize

DecoratedModelsSection バッファーのサイズ (文字単位)。 DecoratedModelsSection が NULL の場合、このパラメーターは 0 に設定する必要があります。

[out, optional] RequiredSize

修飾された Models セクション名と終端の NULL 文字を取得するために必要な DecoratedModelsSection バッファーのサイズを文字単位で受け取る DWORD 型変数へのポインター。 このパラメーターは省略可能であり、 NULL に設定できます。

Reserved

内部システム用に予約されています。 このパラメーターは NULL に設定する必要があります。

戻り値

操作が成功した場合、SetupDiGetActualModelsSection は TRUE を返します。 それ以外の場合、関数は FALSE を 返し、ログに記録されたエラーを GetLastError の呼び出しで取得できます。

解説

SetupDiGetActualModelsSection は、製造元識別子エントリ (Context によって提供される) のどの TargetOSVersion フィールドを現在のプラットフォームに適用するか (AlternatePlatformInfo が指定されていない場合)、または代替プラットフォーム情報が提供されている場合は代替プラットフォームに適用するかを決定します。 SetupDiGetActualModelsSection は、すべての TargetOSVersion フィールドに基づいて最も適切なプラットフォームを選択し、 TargetOSVersion 文字列を INF Models セクション名に追加し、装飾された INF Models セクション名を呼び出し元に返します。 製造元識別子エントリでは、オペレーティング システムのメジャー バージョンは OSMajorVersion フィールドで指定され、オペレーティング システムのマイナー バージョンは OSMinorVersion フィールドで指定されます。

デバイスの INF DDInstall セクション の取得の詳細については、「 SetupDiGetActualSectionToInstall」を参照してください。

注意

setupapi.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして SetupDiGetActualModelsSection を定義します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

   
サポートされている最小のクライアント Windows Server 2003 Service Pack 1 (SP1) 以降のバージョンの Windows で使用できます。
対象プラットフォーム デスクトップ
Header setupapi.h (Setupapi.h を含む)
Library Setupapi.lib

関連項目

INF DDInstall セクション

SP_ALTPLATFORM_INFO

SetupDiGetActualSectionToInstall