Función SetupDiGetActualSectionToInstallExA (setupapi.h)
La función SetupDiGetActualSectionToInstallEx recupera el nombre de la sección INF DDInstall que instala un dispositivo para un sistema operativo y una arquitectura de procesador especificadas.
Sintaxis
WINSETUPAPI BOOL SetupDiGetActualSectionToInstallExA(
[in] HINF InfHandle,
[in] PCSTR InfSectionName,
[in, optional] PSP_ALTPLATFORM_INFO AlternatePlatformInfo,
[out, optional] PSTR InfSectionWithExt,
[in] DWORD InfSectionWithExtSize,
[out, optional] PDWORD RequiredSize,
[out, optional] PSTR *Extension,
PVOID Reserved
);
Parámetros
[in] InfHandle
Identificador del archivo INF que contiene la sección DDInstall .
[in] InfSectionName
Puntero al nombre de la sección DDInstall (como se especifica en una sección Modelos INF). La longitud máxima del nombre de sección, en caracteres, es 254.
[in, optional] AlternatePlatformInfo
Puntero, si no es NULL, a una estructura de SP_ALTPLATFORM_INFO . Esta estructura se usa para especificar un sistema operativo y una arquitectura de procesador diferente de la del equipo local. Para devolver el nombre de la sección DDInstall para el equipo local, establezca este parámetro en NULL. De lo contrario, proporcione una estructura SP_ALTPLATFORM y establezca sus miembros de la siguiente manera:
cbSize
Establezca en el tamaño, en bytes, de una estructura de SP_ALTPLATFORM_INFO.
Plataforma
Establézcalo en VER_PLATFORM_WIN32_NT para Windows XP y versiones posteriores de Windows.
MajorVersion
No se usa.
MinorVersion
no se usa.
ProcessorArchitecture
Establezca una de las siguientes constantes de arquitectura de procesador.
| Constante de arquitectura del procesador | Significado |
|---|---|
| PROCESSOR_ARCHITECTURE_INTEL | La plataforma alternativa es una arquitectura de procesador basada en x86. |
| PROCESSOR_ARCHITECTURE_IA64 | La plataforma alternativa es una arquitectura de procesador basada en Itanium. |
| PROCESSOR_ARCHITECTURE_AMD64 | La plataforma alternativa es una arquitectura de procesador basada en x64. |
Reservado
Establecer en cero.
[out, optional] InfSectionWithExt
Puntero a un búfer de caracteres para recibir el nombre de la sección DDInstall , su extensión de plataforma y un terminador NULL. Este es el nombre de sección representativo que se debe usar para la instalación. 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 DDInstall , su extensión de plataforma y un carácter NULL de terminación.
[in] InfSectionWithExtSize
Tamaño, en caracteres, del búfer al que apunta el parámetro InfSectionWithExt . La longitud máxima de un nombre de sección INF terminado en NULL, en caracteres, es MAX_INF_SECTION_NAME_LENGTH.
[out, optional] RequiredSize
Puntero a la variable que recibe el tamaño, en caracteres, necesario para devolver el nombre de la sección DDInstall , la extensión de plataforma y un carácter NULL de terminación.
[out, optional] Extension
Puntero a una variable que recibe un puntero al carácter '.' que marca el inicio de la extensión en el búfer InfSectionWithExt . Si el búfer InfSectionWithExt no se proporciona o es demasiado pequeño, este parámetro no se establece. Establezca este parámetro en NULL si no se requiere un puntero a la extensión.
Reserved
Reservado para uso interno. Debe establecerse en NULL.
Valor devuelto
Si la función se ejecuta correctamente, devuelve TRUE. De lo contrario, devuelve FALSE. Para obtener información de error extendida, llame a GetLastError.
Comentarios
SetupDiGetActualSectionToInstallEx es una forma extendida de SetupDiGetActualSectionToInstall. Estas funciones admiten las extensiones a los nombres de sección DDInstall que se usan para especificar acciones de instalación específicas del sistema operativo y específicas de la arquitectura para un dispositivo. Para obtener información sobre estas extensiones, vea Creating INF Files for Multiple Platforms and Operating Systems.
Si no proporciona información de plataforma alternativa con una llamada a SetupDiGetActualSectionToInstallEx, la función realiza la misma operación que SetupDiGetActualSectionToInstall. Esta última función busca el nombre de la sección de instalación especificado mediante la información de la plataforma para el equipo local.
Si proporciona información de plataforma alternativa con una llamada a SetupDiGetActualSectionToInstallEx, la función hace lo siguiente:
-
Si especifica una plataforma de VER_PLATFORM_WIN32_NT, la función busca primero en el archivo INF especificado un nombre de sección de instalación representativo que coincida con el nombre, el sistema operativo y la arquitectura del procesador que especifique. Si, por ejemplo, especifica un nombre de sección de instalación de InstallSec, la función busca uno de los siguientes nombres representativos, en función de la arquitectura de procesador especificada:
- Si especifica la arquitectura de procesador basada en x86, la función busca el nombre representativo InstallSec.ntx86.
- Si especifica la arquitectura de procesador basada en x64, la función busca el nombre representativo InstallSec.ntamd64.
- Si especifica la arquitectura del procesador basado en Itanium, la función busca el nombre representativo InstallSec.ntia64.
Si la función encuentra una coincidencia para el nombre, el sistema operativo y la arquitectura del procesador, finaliza la búsqueda y devuelve el nombre representativo correspondiente. Si la función no encuentra esta coincidencia, la función busca una sección cuyo nombre sea InstallSec.nt. Si la función encuentra una coincidencia con InstallSec.nt, finaliza la búsqueda y devuelve este nombre. Si la función no encuentra una coincidencia para ninguna de las búsquedas anteriores, devuelve InstallSec, pero no comprueba que el archivo INF contenga una sección de instalación cuyo nombre sea InstallSec.
Nota
El encabezado setupapi.h define SetupDiGetActualSectionToInstallEx 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 Convenciones para prototipos de función.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Windows XP y versiones posteriores de Windows. |
| Plataforma de destino | Escritorio |
| Encabezado | setupapi.h (incluya Setupapi.h) |
| Library | Setupapi.lib |
Consulte también
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de