SetupDiGetActualSectionToInstallExA 関数 (setupapi.h)

[アーティクル]
08/26/2023

SetupDiGetActualSectionToInstallEx 関数は、指定したオペレーティングシステムとプロセッサアーキテクチャ用のデバイスをインストールする INF DDInstall セクションの名前を取得します。

構文

WINSETUPAPI BOOL SetupDiGetActualSectionToInstallExA(
  [in]            HINF                 InfHandle,
  [in]            PCSTR                InfSectionName,
  [in, optional]  PSP_ALTPLATFORM_INFO AlternatePlatformInfo,
  [out, optional] PSTR                 InfSectionWithExt,
  [in]            DWORD                InfSectionWithExtSize,
  [out, optional] PDWORD               RequiredSize,
  [out, optional] PSTR                 *Extension,
                  PVOID                Reserved
);

パラメーター

[in] InfHandle

DDInstall セクションを含む INF ファイルへのハンドル。

[in] InfSectionName

DDInstall セクション名へのポインター (INF モデルセクションで指定)。セクション名の最大長 (文字数) は 254 です。

[in, optional] AlternatePlatformInfo

null 以外の場合は、SP_ALTPLATFORM_INFO構造体へのポインター。この構造は、ローカルコンピューター上とは異なるオペレーティングシステムとプロセッサアーキテクチャを指定するために使用されます。ローカルコンピューターの DDInstall セクション名を取得するには、このパラメーターを NULL に設定 します。それ以外の場合は、SP_ALTPLATFORM構造体を指定し、そのメンバーを次のように設定します。

cbSize

SP_ALTPLATFORM_INFO構造体のサイズ (バイト単位) に設定します。

プラットフォーム

Windows XP 以降のバージョンの Windows のVER_PLATFORM_WIN32_NTに設定します。

MajorVersion

使用されていません。

MinorVersion

使用されません。

ProcessorArchitecture

次のいずれかのプロセッサアーキテクチャ定数を設定します。

プロセッサアーキテクチャ定数	意味
PROCESSOR_ARCHITECTURE_INTEL	代替プラットフォームは、x86 ベースのプロセッサアーキテクチャです。
PROCESSOR_ARCHITECTURE_IA64	代替プラットフォームは、Itanium ベースのプロセッサアーキテクチャです。
PROCESSOR_ARCHITECTURE_AMD64	代替プラットフォームは、x64 ベースのプロセッサアーキテクチャです。

予約済み

0 に設定します。

[out, optional] InfSectionWithExt

DDInstall セクション名、そのプラットフォーム拡張機能、および NULL 終端記号を受け取る文字バッファーへのポインター。これは、インストールに使用する必要がある装飾されたセクション名です。このパラメーターが NULL の場合、関数は TRUE を返し、DDInstall セクション名、そのプラットフォーム拡張機能、および終端の NULL 文字を返すために必要なサイズ (文字数) に RequiredSize を設定します。

[in] InfSectionWithExtSize

InfSectionWithExt パラメーターが指すバッファーのサイズ (文字数)。 NULL で終わる INF セクション名の最大長 (文字数) はMAX_INF_SECTION_NAME_LENGTH。

[out, optional] RequiredSize

DDInstall セクション名、プラットフォーム拡張機能、および終端の NULL 文字を返すために必要な、サイズ (文字数) を受け取る変数へのポインター。

[out, optional] Extension

InfSectionWithExt バッファー内の拡張機能の開始をマークする '.' 文字へのポインターを受け取る変数へのポインター。 InfSectionWithExt バッファーが指定されていないか、小さすぎる場合、このパラメーターは設定されません。拡張機能へのポインターが必要ない場合は、このパラメーターを NULL に設定します。

Reserved

内部使用専用に予約されています。 NULL に設定する必要があります。

戻り値

関数が成功すると、 TRUE が返されます。それ以外の場合は、 FALSE を返します。詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

SetupDiGetActualSectionToInstallEx は、SetupDiGetActualSectionToInstall の拡張形式です。これらの関数は、デバイスの OS 固有およびアーキテクチャ固有のインストールアクションを指定するために使用される DDInstall セクション名の拡張機能をサポートします。これらの拡張機能の詳細については、「複数のプラットフォームとオペレーティングシステム用の INF ファイルの作成」を参照してください。

SetupDiGetActualSectionToInstallEx の呼び出しで代替プラットフォーム情報を指定しない場合、関数は SetupDiGetActualSectionToInstall と同じ操作を実行します。後者の関数は、ローカルコンピューターのプラットフォーム情報を使用して、指定されたインストールセクション名を検索します。

SetupDiGetActualSectionToInstallEx の呼び出しで代替プラットフォーム情報を指定すると、関数は次の処理を行います。

VER_PLATFORM_WIN32_NTのプラットフォームを指定した場合、関数は最初に指定した INF ファイル内で、指定した名前、オペレーティングシステム、およびプロセッサアーキテクチャに一致する装飾されたインストールセクション名を検索します。たとえば、 InstallSec のインストールセクション名を指定した場合、関数は、指定されたプロセッサアーキテクチャに応じて、次のいずれかの修飾名を検索します。
- x86 ベースのプロセッサアーキテクチャを指定すると、関数は 修飾名 InstallSec.ntx86 を検索します。
- x64 ベースのプロセッサアーキテクチャを指定すると、関数は 装飾名 InstallSec.ntamd64 を検索します。
- Itanium ベースのプロセッサアーキテクチャを指定すると、関数は 装飾名 InstallSec.ntia64 を検索します。
関数は、名前、オペレーティングシステム、およびプロセッサアーキテクチャの一致を検出すると、検索を終了し、対応する装飾名を返します。関数でこのような一致が見つからない場合、関数は InstallSec.nt という名前のセクションを検索します。 関数が InstallSec.nt の一致を検出すると、検索が終了し、この名前が返されます。関数は、上記の検索のいずれにも一致するものが見つからない場合は InstallSec を返しますが、INF ファイルに InstallSec という名前のインストールセクションが含まれていることは確認しません。

注意

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

要件

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

こちらもご覧ください

INF DDInstall セクション

SetupDiGetActualSectionToInstallEx

SetupDiInstallDevice

次の方法で共有