SetupDiGetActualModelsSectionA-Funktion (setupapi.h)

Die SetupDiGetActualModelsSection-Funktion ruft den entsprechenden InF-Abschnitt ab, der bei der Installation eines Geräts aus einer GeräteINF-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 Eintrag manufacturer-identifier gibt einen InF-Modellabschnittsnamen an und gibt optional TargetOSVersion-Dekorationen für den Namen des Abschnitts Models 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. 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 dekorierten INF Models-Abschnittsnamen und einen NULL-Abschlussator enthält. Wenn AlternatePlatformInfo nicht bereitgestellt wird, gilt der Name des dekorierten INF-Modells-Abschnitts 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 dekorierten Models-Abschnitts und ein beendendes 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, die erforderlich ist, um den Namen des dekorierten Models-Abschnitts und ein beendendes 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 Eintrag Herstellerbezeichner (von Context bereitgestellt) für die aktuelle Plattform gelten, wenn AlternatePlatformInfo nicht bereitgestellt wird, oder auf eine alternative Plattform, wenn Informationen zu alternativen Plattformen 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 ABSCHNITTS "INF-Modelle" an und gibt den namen des dekorierten INF-Modells-Abschnitts 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 automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, 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
Kopfzeile	setupapi.h (einschließlich Setupapi.h)
Bibliothek	Setupapi.lib

Weitere Informationen

ABSCHNITT INF DDInstall

SP_ALTPLATFORM_INFO

SetupDiGetActualSectionToInstall