Función SetupDiGetActualSectionToInstallExA (setupapi.h)
La función SetupDiGetActualSectionToInstallEx recupera el nombre de la sección INF DDInstall que instala un dispositivo para una arquitectura de procesador y sistema operativo especificada.
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
[in] InfSectionName
Puntero al nombre de la sección
[in, optional] AlternatePlatformInfo
Puntero, si noNULL, 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
cbSize
Establézcalo en el tamaño, en bytes, de una estructura SP_ALTPLATFORM_INFO.
Plataforma
Establezca 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
Establézcalo en cero.
[out, optional] InfSectionWithExt
Puntero a un búfer de caracteres para recibir el nombre de sección DDInstall, su extensión de plataforma y un terminador NULL. Este es el nombre de sección decorado que se debe usar para la instalación. 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 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 terminada en NULL, en caracteres, es MAX_INF_SECTION_NAME_LENGTH.
[out, optional] RequiredSize
Puntero a la variable que recibe el tamaño, en caracteres, que es necesario para devolver el DDInstall nombre de sección, 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 de InfSectionWithExt. Si el infSectionWithExt búfer 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 solo 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.
Observaciones
SetupDiGetActualSectionToInstallEx es una forma extendida de SetupDiGetActualSectionToInstall. Estas funciones admiten las extensiones para DDInstall nombres de sección 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 Creación de archivos INF para varias plataformas y sistemas operativos.
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 especificada 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 decorado 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 decorados, en función de la arquitectura de procesador especificada:
- Si especifica la arquitectura de procesador basada en x86, la función busca el nombre decorado InstallSec.ntx86.
- Si especifica la arquitectura de procesador basada en x64, la función busca el nombre decorado InstallSec.ntamd64.
- Si especifica la arquitectura del procesador basado en Itanium, la función busca el nombre decorado InstallSec.ntia64.
Si la función encuentra una coincidencia con 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 es InstallSec.nt. Si la función encuentra una coincidencia para InstallSec.nt, finaliza la búsqueda y devuelve este nombre. Si la función no encuentra ninguna 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 Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible en Windows XP y versiones posteriores de Windows. |
| de la plataforma de destino de |
Escritorio |
| encabezado de |
setupapi.h (incluya Setupapi.h) |
| biblioteca de |
Setupapi.lib |