次の方法で共有

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 ファイル を使用した に関するプラットフォーム SDK のトピックと、INFCONTEXT 構造体を参照してください。

[in, optional] AlternatePlatformInfo

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

[out, optional] InfSectionWithExt

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

[in] InfSectionWithExtSize

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

[out, optional] RequiredSize

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

Reserved

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

戻り値

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

備考

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

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

手記

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

必要条件

要件 価値
サポートされる最小クライアント Windows Server 2003 Service Pack 1 (SP1) 以降のバージョンの Windows で使用できます。
ターゲット プラットフォーム の デスクトップ
ヘッダー setupapi.h (Setupapi.h を含む)
ライブラリ Setupapi.lib

関連項目

INF DDInstall セクション

SP_ALTPLATFORM_INFO

SetupDiGetActualSectionToInstall の