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 |