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

Weitere Informationen

ABSCHNITT "INF DDInstall"

SP_ALTPLATFORM_INFO

SetupDiGetActualSectionToInstall