Fonction SetupDiGetActualModelsSectionW (setupapi.h)

Article
08/26/2023

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 SetupDiGetActualModelsSectionW(
  [in]            PINFCONTEXT          Context,
  [in, optional]  PSP_ALTPLATFORM_INFO AlternatePlatformInfo,
  [out, optional] PWSTR                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 spécifie éventuellement les décorations TargetOSVersion pour le nom de la section Modèles. 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 la structure INFCONTEXT.

[in, optional] AlternatePlatformInfo

Pointeur vers une structure 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 la section Modèles INF décoré et une terminaison NULL. Si AlternatePlatformInfo n’est pas fourni, le nom de la section Modèles INF décorés 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, requise 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.

Remarques

SetupDiGetActualModelsSection détermine quels champs TargetOSVersion dans l’entrée manufacturer-identifier (fournie 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 section Modèles INF 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 comme un 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. Le mélange 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

Condition requise	Valeur
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

Voir aussi

INF DDInstall Section

SP_ALTPLATFORM_INFO

SetupDiGetActualSectionToInstall

Partager via