SetupDiGetActualModelsSectionW, fonction (setupapi.h)

Article
11/20/2024

La fonction setupDiGetActualModelsSection récupère la section modèles INF décorée 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 d’identificateur de fabricant dans une section fabricant INF d’un fichier INF. L''entrée d’identificateur de fabricant spécifie un nom de section INF Models et spécifie éventuellement décorations TargetOSVersion pour le nom de 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’aide de 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 cbSize membre 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 décoré Models 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 à la plateforme alternative spécifiée. Ce paramètre est facultatif et peut être défini sur NULL. Si ce paramètre est NULL, la fonction retourne TRUE et définit RequiredSize sur la taille, en caractères, qui est nécessaire pour renvoyer le nom de section Models décoré et un caractère NULL de fin.

[in] InfSectionWithExtSize

Taille, en caractères, de la mémoire tampon DecoratedModelsSection . Si decoratedModelsSection est 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 de DecoratedModelsSection requise pour récupérer le nom de section Models décoré 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 de retour

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 les champs TargetOSVersion dans l’entrée d’identificateur de fabricant (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 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.

Note

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. 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Disponible dans Windows Server 2003 avec Service Pack 1 (SP1) et versions ultérieures de Windows.
plateforme cible	Bureau
d’en-tête	setupapi.h (include Setupapi.h)
bibliothèque	Setupapi.lib

Voir aussi

section DDInstall INF

SP_ALTPLATFORM_INFO

SetupDiGetActualSectionToInstall

Partager via