Función SetupDiGetActualSectionToInstallExW (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 SetupDiGetActualSectionToInstallExW(
  [in]            HINF                 InfHandle,
  [in]            PCWSTR               InfSectionName,
  [in, optional]  PSP_ALTPLATFORM_INFO AlternatePlatformInfo,
  [out, optional] PWSTR                InfSectionWithExt,
  [in]            DWORD                InfSectionWithExtSize,
  [out, optional] PDWORD               RequiredSize,
  [out, optional] PWSTR                *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 del equipo local, establezca este parámetro en NULL. De lo contrario, proporcione una estructura de SP_ALTPLATFORM y establezca sus miembros de la siguiente manera:

cbSize

Se establece en el tamaño, en bytes, de una estructura de 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 del procesador.

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 decorado 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 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, necesario para devolver el nombre de 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 en 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 Crear archivos INF para varias plataformas y sistemas operativos.

Si no proporciona información alternativa de plataforma con una llamada a SetupDiGetActualSectionToInstallEx, la función realiza la misma operación que SetupDiGetActualSectionToInstall. La ú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, se 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 tal 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 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.

Requisitos

Consulte también

Sección INF DDInstall

SetupDiGetActualSectionToInstallEx

SetupDiInstallDevice