SetupDiGetActualModelsSectionA, fonction (setupapi.h)
La fonction SetupDiGetActualModelsSection récupère la section modèles INF décorées 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 d’identificateur de fabricant dans une section Fabricant INF d’un fichier INF. L’entrée manufacturer-identifier spécifie un nom de section INF Models et spécifie éventuellement les décorations TargetOSVersion pour le nom de la section Models . Pour plus d’informations sur les fichiers INF et un contexte de fichier INF, consultez les rubriques du Kit de développement logiciel (SDK) de plateforme sur l’utilisation des fichiers INF et de la structure INFCONTEXT.
[in, optional] AlternatePlatformInfo
Pointeur vers une structure SP_ALTPLATFORM_INFO qui fournit des informations sur une version et une architecture de processeur Windows. 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 la section Modèles INF décoré et un terminateur NULL. Si AlternatePlatformInfo n’est pas fourni, le nom de la section Modèles INF décoré s’applique à la plateforme actuelle ; sinon, le nom s’applique à la plateforme alternative 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, qui est nécessaire pour renvoyer le nom de la 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 avoir la valeur 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.
Notes
SetupDiGetActualModelsSection détermine les champs TargetOSVersion de l’entrée d’identificateur de fabricant (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 Modèles INF et retourne le nom de la section Modèles INF décorée à 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 DDInstall INF pour un appareil, consultez SetupDiGetActualSectionToInstall.
Notes
L’en-tête setupapi.h définit SetupDiGetActualModelsSection comme 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 | Desktop (Expérience utilisateur) |
| En-tête | setupapi.h (inclure Setupapi.h) |
| Bibliothèque | Setupapi.lib |