SetupDiGetActualModelsSectionA, fonction (setupapi.h)

La fonction SetupDiGetActualModelsSection récupère la section modèles INF décorés appropriée à utiliser lors de l’installation d’un appareil à partir d’un fichier INF d’appareil.

Syntaxe

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
);

Paramètres

[in] Context

Pointeur vers un contexte de fichier INF qui spécifie une entrée manufacturer-identifier dans une section INF Manufacturer d’un fichier INF. L’entrée manufacturer-identifier spécifie un nom de section Inf Models et éventuellement des décorations TargetOSVersion pour le nom de la section Models . Pour plus d’informations sur les fichiers INF et le contexte d’un fichier INF, consultez les rubriques du Kit de développement logiciel (SDK) de plateforme sur l’utilisation des fichiers INF et la structure INFCONTEXT.

[in, optional] AlternatePlatformInfo

Pointeur vers une structure de SP_ALTPLATFORM_INFO qui fournit des informations sur une version de Windows et une architecture de processeur. Le membre cbSize de cette structure doit être défini sur sizeof(SP_ALTPLATFORM_INFO_V2). Ce paramètre est facultatif et peut être défini sur NULL.

[out, optional] InfSectionWithExt

Pointeur vers une mémoire tampon qui reçoit une chaîne qui contient le nom de section inf models décoré et un terminateur NULL. Si AlternatePlatformInfo n’est pas fourni, le nom de section Inf Models décoré s’applique à la plateforme actuelle ; sinon, le nom s’applique à l’autre plateforme spécifiée. Ce paramètre est facultatif et peut être défini sur NULL. Si ce paramètre a la valeur NULL, la fonction retourne TRUE et définit RequiredSize sur la taille, en caractères, requise pour renvoyer le nom de section Modèles décorés et un caractère NULL de fin.

[in] InfSectionWithExtSize

Taille, en caractères, de la mémoire tampon DecoratedModelsSection . Si DecoratedModelsSection a la valeur NULL, ce paramètre doit être défini sur zéro.

[out, optional] RequiredSize

Pointeur vers une variable de type DWORD qui reçoit la taille, en caractères, de la mémoire tampon DecoratedModelsSection requise pour récupérer le nom de la section Modèles décorés et un caractère NULL de fin. Ce paramètre est facultatif et peut être défini sur NULL.

Reserved

Réservé à une utilisation interne du système. Ce paramètre doit être défini sur NULL.

Valeur retournée

SetupDiGetActualModelsSection retourne TRUE si l’opération réussit. Sinon, la fonction retourne FALSE et l’erreur journalisée peut être récupérée avec un appel à GetLastError.

Remarques

SetupDiGetActualModelsSection détermine quels champs TargetOSVersion dans l’entrée manufacturer-identifier (fourni par Context) s’appliquent à la plateforme actuelle, si AlternatePlatformInfo n’est pas fourni, ou à une autre plateforme, si d’autres informations de plateforme sont fournies. SetupDiGetActualModelsSection sélectionne la plateforme la plus appropriée en fonction de tous les champs TargetOSVersion , ajoute la chaîne TargetOSVersion au nom de la section Inf Models et retourne le nom de section Inf Models décoré à l’appelant. Dans une entrée d’identificateur de fabricant , la version principale du système d’exploitation est spécifiée par le champ OSMajorVersion et la version mineure du système d’exploitation est spécifiée par le champ OSMinorVersion .

Pour plus d’informations sur la récupération d’une section INF DDInstall pour un appareil, consultez SetupDiGetActualSectionToInstall.

Notes

L’en-tête setupapi.h définit SetupDiGetActualModelsSection en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Client minimal pris en charge	Disponible dans Windows Server 2003 avec Service Pack 1 (SP1) et versions ultérieures de Windows.
Plateforme cible	Bureau
En-tête	setupapi.h (inclure Setupapi.h)
Bibliothèque	Setupapi.lib

Voir aussi

Inf DDInstall, section

SP_ALTPLATFORM_INFO

SetupDiGetActualSectionToInstall