Función SetupDiGetActualModelsSectionA (setupapi.h)

La función setupDiGetActualModelsSection recupera la sección modelos inf de adecuada usar al instalar un dispositivo desde un archivo INF del dispositivo.

Sintaxis

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

Parámetros

[in] Context

Puntero a un contexto de archivo INF que especifica una entrada de identificador de fabricante en una sección fabricante de INF de un archivo INF. La entrada identificador de fabricante especifica un nombre de sección de modelos INF y, opcionalmente, especifica decoración de TargetOSVersion para el nombre de sección Models de . Para obtener información sobre los archivos INF y un contexto de archivo INF, consulte los temas del SDK de plataforma sobre mediante archivos INF y la estructura INFCONTEXT.

[in, optional] AlternatePlatformInfo

Puntero a una estructura SP_ALTPLATFORM_INFO que proporciona información sobre una arquitectura de procesador y versión de Windows. El miembro cbSize de esta estructura debe establecerse en sizeof(SP_ALTPLATFORM_INFO_V2). Este parámetro es opcional y se puede establecer en NULL.

[out, optional] InfSectionWithExt

Puntero a un búfer que recibe una cadena que contiene el inf decorado Models nombre de sección y un terminador NULL. Si no se proporciona AlternatePlatformInfo, el nombre de sección de inf Models decorado se aplica a la plataforma actual; de lo contrario, el nombre se aplica a la plataforma alternativa especificada. Este parámetro es opcional y se puede establecer en NULL. Si este parámetro es NULL, la función devuelve TRUE y establece RequiredSize al tamaño, en caracteres, que es necesario para devolver el nombre de sección Models y un carácter NULL de terminación.

[in] InfSectionWithExtSize

Tamaño, en caracteres, del búfer DecoratedModelsSection . Si decoratedModelsSection es null, este parámetro debe establecerse en cero.

[out, optional] RequiredSize

Puntero a una variable de tipo DWORD que recibe el tamaño, en caracteres, del DecoratedModelsSection búfer que es necesario para recuperar el nombre de sección Models decorado y un carácter NULL de terminación. Este parámetro es opcional y se puede establecer en NULL.

Reserved

Reservado para uso interno del sistema. Este parámetro debe establecerse en NULL.

Valor devuelto

setupDiGetActualModelsSection devuelve TRUE si la operación se realiza correctamente. De lo contrario, la función devuelve FALSE y el error registrado se puede recuperar con una llamada a GetLastError.

Observaciones

setupDiGetActualModelsSection determina qué campos TargetOSVersion en la entrada de identificador de fabricante (proporcionado por Context) se aplican a la plataforma actual, si no se proporciona AlternatePlatformInfo, o a una plataforma alternativa, si se proporciona información de plataforma alternativa. setupDiGetActualModelsSection selecciona la plataforma más adecuada en función de todos los campos targetOSVersion de , anexa la cadena TargetOSVersion al nombre de la sección INF Models y devuelve el nombre de la sección inf Models al autor de la llamada. En una entrada de identificador de fabricante de , la versión principal del sistema operativo se especifica mediante el campo OSMajorVersion y la versión secundaria del sistema operativo se especifica mediante el campo OSMinorVersion.

Para obtener información sobre cómo recuperar una sección INF DDInstall para un dispositivo, consulte SetupDiGetActualSectionToInstall.

Nota

El encabezado setupapi.h define SetupDiGetActualModelsSection como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Disponible en Windows Server 2003 con Service Pack 1 (SP1) y versiones posteriores de Windows.
de la plataforma de destino de	Escritorio
encabezado de	setupapi.h (incluya Setupapi.h)
biblioteca de	Setupapi.lib

Consulte también

sección INF DDInstall

SP_ALTPLATFORM_INFO

SetupDiGetActualSectionToInstall