SetupDiGetActualModelsSectionW-Funktion (setupapi.h)
Die SetupDiGetActualModelsSection-Funktion ruft den entsprechenden abschnitt mit inf-Modellen ab, der bei der Installation eines Geräts aus einer INF-Datei verwendet werden soll.
Syntax
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
);
Parameter
[in] Context
Ein Zeiger auf einen INF-Dateikontext, der einen Herstellerbezeichnereintrag in einem INF-Herstellerabschnitt einer INF-Datei angibt. Der Eintrag manufacturer-identifier gibt einen Inf Models-Abschnittsnamen und optional TargetOSVersion-Dekorationen für den Namen des Abschnitts Modelle an. Informationen zu INF-Dateien und einem INF-Dateikontext finden Sie in den Platform 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. Der cbSize-Member 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 ergänzten INF-Modellabschnittsnamen und ein NULL-Abschlusszeichen enthält. Wenn AlternatePlatformInfo nicht bereitgestellt wird, gilt der ergänzte InF-Modellabschnittsname 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 namen des ergänzten Models-Abschnitts und ein abschließendes 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 Variable vom Typ DWORD, die die Größe des DecoratedModelsSection-Puffers in Zeichen empfängt, der erforderlich ist, um den Namen des dekorierten Models-Abschnitts und ein abschließendes NULL-Zeichen abzurufen. 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 GetLastError abgerufen werden.
Hinweise
SetupDiGetActualModelsSection bestimmt, welche TargetOSVersion-Felder im Herstellerbezeichnereintrag (von Context bereitgestellt) für die aktuelle Plattform gelten, wenn AlternatePlatformInfo nicht bereitgestellt wird, oder auf eine alternative Plattform, wenn Informationen zur alternativen Plattform bereitgestellt werden. SetupDiGetActualModelsSection wählt basierend auf allen TargetOSVersion-Feldern die am besten geeignete Plattform aus, fügt die TargetOSVersion-Zeichenfolge an den Namen des INF Models-Abschnitts an und gibt den ergänzten INF-Modellabschnittsnamen an den Aufrufer zurück. In einem Herstellerbezeichnereintrag wird die Hauptversion des Betriebssystems durch das Feld OSMajorVersion und die Nebenversion des Betriebssystems durch das 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ä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 |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows Server 2003 mit Service Pack 1 (SP1) und höheren Versionen von Windows. |
| Zielplattform | Desktop |
| Kopfzeile | setupapi.h (schließen Sie Setupapi.h ein) |
| Bibliothek | Setupapi.lib |