SetupDiGetActualModelsSectionA-Funktion (setupapi.h)
Die SetupDiGetActualModelsSection-Funktion ruft den geeigneten ABSCHNITT "INF-Modelle" ab, der beim Installieren eines Geräts aus einer INF-Datei verwendet werden soll.
Syntax
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
);
Parameter
[in] Context
Ein Zeiger auf einen INF-Dateikontext, der einen Herstellerbezeichner Eintrag in einem abschnitt INF Manufacturer einer INF-Datei angibt. Der Herstellerbezeichner Eintrag gibt einen INF-Models Abschnittsnamen an und gibt optional TargetOSVersion- Dekorationen für den Models Abschnittsnamen an. Informationen zu INF-Dateien und einem INF-Dateikontext finden Sie in den Platform SDK-Themen zu verwendung von INF-Dateien und der INFCONTEXT-Struktur.
[in, optional] AlternatePlatformInfo
Ein Zeiger auf eine SP_ALTPLATFORM_INFO-Struktur, die Informationen zu einer Windows-Version und Prozessorarchitektur bereitstellt. Das cbSize Mitglied dieser Struktur muss auf Größe(SP_ALTPLATFORM_INFO_V2)festgelegt werden. Dieser Parameter ist optional und kann auf NULL-festgelegt werden.
[out, optional] InfSectionWithExt
Ein Zeiger auf einen Puffer, der eine Zeichenfolge empfängt, die den verzierten INF-Models Abschnittsnamen und einen NULL-Endator enthält. Wenn AlternatePlatformInfo- nicht angegeben wird, gilt der dekorierte INF-Models Abschnittsname für die aktuelle Plattform; andernfalls gilt der Name für die angegebene alternative Plattform. Dieser Parameter ist optional und kann auf NULL-festgelegt werden. Wenn dieser Parameter NULL-ist, gibt die Funktion TRUE zurück und legt RequiredSize- auf die Größe in Zeichen fest, die erforderlich ist, um den versehenen Models Abschnittsnamen und ein endendes NULL-Zeichen zurückzugeben.
[in] InfSectionWithExtSize
Die Größe des DecoratedModelsSection Puffers in Zeichen. Wenn DecoratedModelsSectionNULL-ist, muss dieser Parameter auf Null festgelegt werden.
[out, optional] RequiredSize
Ein Zeiger auf eine DWORD-Typvariable, die die Größe des DecoratedModelsSection- Puffers empfängt, der zum Abrufen des verzierten Models Abschnittsnamen und eines endenden NULL-Zeichens erforderlich ist. Dieser Parameter ist optional und kann auf NULL-festgelegt werden.
Reserved
Reserviert für die interne Systemverwendung. Dieser Parameter muss auf NULL-festgelegt werden.
Rückgabewert
SetupDiGetActualModelsSection gibt TRUE- zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt die Funktion FALSE- zurück, und der protokollierte Fehler kann mit einem Aufruf von GetLastErrorabgerufen werden.
Bemerkungen
SetupDiGetActualModelsSection- bestimmt, welche TargetOSVersion-Felder im Hersteller bezeichnereintrag (bereitgestellt von Context) auf die aktuelle Plattform angewendet werden, wenn AlternatePlatformInfo nicht angegeben wird oder auf eine alternative Plattform, wenn alternative Plattforminformationen bereitgestellt werden. SetupDiGetActualModelsSection wählt die am besten geeignete Plattform basierend auf allen TargetOSVersion- Feldern aus, fügt die TargetOSVersion- Zeichenfolge an den Namen des INF-Models Abschnitts an und gibt den verzierten INF-Models Abschnittsnamen an den Aufrufer zurück. In einem Herstellerbezeichner Eintrag wird die Hauptversion des Betriebssystems durch das Feld OSMajorVersion angegeben, und die Nebenversion des Betriebssystems wird durch das feld OSMinorVersion angegeben.
Informationen zum Abrufen eines INF DDInstall-Abschnitts für ein Gerät finden Sie unter SetupDiGetActualSectionToInstall.
Anmerkung
Der header setupapi.h definiert SetupDiGetActualModelsSection als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows Server 2003 mit Service Pack 1 (SP1) und höheren Versionen von Windows. |
| Zielplattform- | Desktop |
| Header- | setupapi.h (include Setupapi.h) |
| Library | Setupapi.lib |