Función SetupDiGetActualSectionToInstallW (setupapi.h)

Artículo
11/20/2024

La función SetupDiGetActualSectionToInstall recupera la sección INF DDInstall adecuada usar al instalar un dispositivo desde un archivo INF de dispositivo en un equipo local.

Sintaxis

WINSETUPAPI BOOL SetupDiGetActualSectionToInstallW(
  [in]            HINF   InfHandle,
  [in]            PCWSTR InfSectionName,
  [out, optional] PWSTR  InfSectionWithExt,
  [in]            DWORD  InfSectionWithExtSize,
  [out, optional] PDWORD RequiredSize,
  [out, optional] PWSTR  *Extension
);

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 de ). La longitud máxima del nombre de sección, en caracteres, es 254.

[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, infSectionWithExtSize debe ser cero. 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 de InfSectionWithExt. Si InfSectionWithExt es NULL, este parámetro debe ser cero.

[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.

Valor devuelto

Si la función se ejecuta correctamente, devuelve TRUE. Si se produce un error en la función, devuelve FALSE. Para obtener información de error extendida, llame a GetLastError.

Observaciones

Esta función admite las extensiones para DDInstall nombres de sección que se usan para especificar comportamientos de instalación específicos del sistema operativo y específicos 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. SetupDiGetActualSectionToInstall busca un nombre de sección de DDInstall que coincida con el equipo local de la manera que se describe a continuación.

La función busca primero en el archivo INF especificado un nombre de sección de instalación decorado que coincide con el nombre especificado y tiene una extensión que coincide con el sistema operativo y la arquitectura del procesador del equipo local. Si, por ejemplo, especifica un nombre de sección de InstallSec, la función busca uno de los siguientes nombres decorados, en función de la arquitectura de procesador del equipo local:

Para un equipo basado en la arquitectura del procesador x86, la función busca el nombre decorado InstallSec.ntx86.
Para un equipo basado en la arquitectura del procesador x64, la función busca el nombre decorado InstallSec.ntamd64.
Para un equipo basado en la arquitectura del procesador 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.

El nombre de la sección DDInstall de se usa como base para los nombres de sección de Hardware y Services. Por ejemplo, si el nombre de sección DDInstall que se encuentra es InstallSec.NTX86, el nombre de sección de Services debe denominarse InstallSec.NTX86.Services.

El nombre de la sección DDInstall original que se especifica en el nodo del controlador se escribe en la entrada de valor InfSe ction de la clave del registro del controlador. La extensión que se encontró se almacena en la clave como valor de REG_SZ InfSectionExt. Por ejemplo:

InfSection       : REG_SZ :    "InstallSec"
InfSectionExt    : REG_SZ :    ".NTX86"

Si no se selecciona un controlador para el elemento de información del dispositivo especificado, se instala un controlador NULL. Tras la devolución, las marcas de la estructura SP_DEVINSTALL_PARAMS del dispositivo indican si el sistema debe reiniciarse o reiniciarse para que el dispositivo se inicie.

Nota

El encabezado setupapi.h define SetupDiGetActualSectionToInstall 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 Microsoft Windows 2000 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

SetupDiGetActualSectionToInstallEx

setupDiInstallDevice

Compartir a través de