SetupDiGetActualModelsSectionA-Funktion (setupapi.h)
Die SetupDiGetActualModelsSection-Funktion ruft den entsprechenden inF-Modelle-Abschnitt 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 Herstellerbezeichnereintrag in einem INF-Herstellerabschnitt einer INF-Datei angibt. Der Herstellerbezeichnereintrag gibt einen Abschnittsnamen für INF-Modelle an und gibt optional TargetOSVersion-Dekorationen für den Abschnittsnamen " Modelle " an. Informationen zu INF-Dateien und einem INF-Dateikontext finden Sie in den Plattform-SDK-Themen zur 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-Element dieser Struktur muss auf sizeof(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 inF-Modellen-Abschnittsnamen und einen NULL-Terminator enthält. Wenn AlternativePlatformInfo nicht angegeben wird, gilt der beschriftete ABSCHNITTsname INF-Modelle 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" in Zeichen fest, die erforderlich sind, um den beschrifteten Abschnittsnamen und ein beendetes NULL-Zeichen zurückzugeben.
[in] InfSectionWithExtSize
Die Größe in Zeichen des DecoratedModelsSection-Puffers . Wenn DecoratedModelsSectionNULL ist, muss dieser Parameter auf Null festgelegt werden.
[out, optional] RequiredSize
Ein Zeiger auf eine DWORD-Typvariable, die die Größe in Zeichen des DecoratedModelsSection-Puffers empfängt, der zum Abrufen des zugewiesenen Abschnittsnamens und eines beendeten NULL-Zeichens erforderlich ist. Dieser Parameter ist optional und kann auf NULL festgelegt werden.
Reserved
Reserviert für die Verwendung des internen Systems. Dieser Parameter muss auf NULL festgelegt werden.
Rückgabewert
SetupDiGetActualModelsSection gibt TRUE zurück, wenn der Vorgang erfolgreich verläuft. Andernfalls gibt die Funktion FALSE zurück, und der protokollierte Fehler kann mit einem Aufruf von GetLastError abgerufen werden.
Hinweise
SetupDiGetActualModelsSection bestimmt, welche TargetOSVersion-Felder im Herstellerbezeichnereintrag (bereitgestellt von Kontext) auf die aktuelle Plattform gelten, wenn AlternativePlatformInfo nicht bereitgestellt 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 Abschnittsnamen der INF-Modelle an, und gibt den benutzerdefinierten ABSCHNITTsnamen INF-Modelle an den Aufrufer zurück. In einem Herstellerbezeichnereintrag wird die Hauptversion des Betriebssystems durch das Feld "OSMajorVersion " angegeben, und die Nebenversion des Betriebssystems wird vom Feld "OSMinorVersion " angegeben.
Informationen zum Abrufen eines INF DDInstall-Abschnitts für ein Gerät finden Sie unter SetupDiGetActualSectionToInstall.
Hinweis
Der Setupapi.h-Header definiert SetupDiGetActualModelsSection als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstanten automatisch auswählt. Das Mischen der Verwendung des Codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann dazu führen, dass keine Übereinstimmungen auftreten, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Unterstützte Mindestversion (Client) | Verfügbar in Windows Server 2003 mit Service Pack 1 (SP1) und höheren Versionen von Windows. |
| Zielplattform | Desktop |
| Header | setupapi.h (einschließlich Setupapi.h) |
| Bibliothek | Setupapi.lib |