SetupDiGetActualModelsSectionW 関数 (setupapi.h)
SetupDiGetActualModelsSection 関数は、デバイス INF ファイルからデバイスをインストールするときに使用する適切な装飾 INF モデル セクションを取得します。
構文
WINSETUPAPI BOOL SetupDiGetActualModelsSectionW(
[in] PINFCONTEXT Context,
[in, optional] PSP_ALTPLATFORM_INFO AlternatePlatformInfo,
[out, optional] PWSTR 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 は、AlternatePlatformInfo が指定されていない場合は現在のプラットフォームに適用される製造元識別子エントリ (Context によって提供) 内の TargetOSVersion フィールドを決定します。代替プラットフォーム情報が指定されている場合は代替プラットフォームに適用されます。 SetupDiGetActualModelsSection は、すべての TargetOSVersion フィールドに基づいて最も適切なプラットフォームを選択し、 TargetOSVersion 文字列を INF Models セクション名に追加し、装飾された INF モデル セクション名を呼び出し元に返します。 製造元識別子エントリでは、オペレーティング システムのメジャー バージョンは OSMajorVersion フィールドで指定され、オペレーティング システムのマイナー バージョンは OSMinorVersion フィールドで指定されます。
デバイスの INF DDInstall セクション の取得の詳細については、「 SetupDiGetActualSectionToInstall」を参照してください。
注意
setupapi.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして SetupDiGetActualModelsSection を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Service Pack 1 (SP1) 以降のバージョンの Windows Server 2003 で使用できます。 |
| 対象プラットフォーム | デスクトップ |
| Header | setupapi.h (Setupapi.h を含む) |
| Library | Setupapi.lib |