Función SetupDiGetActualModelsSectionA (setupapi.h)

La función SetupDiGetActualModelsSection recupera la sección Modelos INF decoradas adecuada para usarla al instalar un dispositivo desde un archivo INF de 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 fabricante de un archivo INF. La entrada de identificador de fabricante especifica un nombre de sección Modelos INF y, opcionalmente, especifica las decoraciones targetOSVersion para el nombre de la sección Models . Para obtener información sobre los archivos INF y un contexto de archivo INF, consulte los temas del SDK de plataforma sobre el uso de archivos INF y la estructura INFCONTEXT.

[in, optional] AlternatePlatformInfo

Puntero a una estructura de 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 nombre de sección de modelos INF decorados y un terminador NULL. Si no se proporciona AlternatePlatformInfo , el nombre de la sección Modelos INF decorados 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 en el tamaño, en caracteres, necesario para devolver el nombre de la sección Modelos decorados y un carácter NULL terminado.

[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 búfer DecoratedModelsSection necesario para recuperar el nombre de la sección Modelos decorados y un carácter NULL terminado. 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.

Comentarios

SetupDiGetActualModelsSection determina qué campos TargetOSVersion de la entrada de identificador de fabricante (proporcionado por Context) se aplican a la plataforma actual, si AlternatePlatformInfo no se proporciona 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 , anexa la cadena TargetOSVersion al nombre de la sección Modelos INF y devuelve el nombre de la sección Modelos INF decorados al autor de la llamada. En una entrada de identificador de fabricante , el campo OSMajorVersion especifica la versión principal del sistema operativo y el campo OSMinorVersion especifica la versión secundaria del sistema operativo.

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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

   
Cliente mínimo compatible Disponible en Windows Server 2003 con Service Pack 1 (SP1) y versiones posteriores de Windows.
Plataforma de destino Escritorio
Encabezado setupapi.h (incluya Setupapi.h)
Library Setupapi.lib

Consulte también

Sección INF DDInstall

SP_ALTPLATFORM_INFO

SetupDiGetActualSectionToInstall