Função SetupDiGetActualSectionToInstallExW (setupapi.h)

  • Artigo

A função SetupDiGetActualSectionToInstallEx recupera o nome da seção INF DDInstall que instala um dispositivo para um sistema operacional e uma arquitetura de processador especificada.

Sintaxe

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

Um identificador para o arquivo INF que contém a seção DDInstall .

[in] InfSectionName

Um ponteiro para o nome da seção DDInstall (conforme especificado em uma seção Modelos INF). O comprimento máximo do nome da seção, em caracteres, é 254.

[in, optional] AlternatePlatformInfo

Um ponteiro, se não NULL, para uma estrutura SP_ALTPLATFORM_INFO . Essa estrutura é usada para especificar um sistema operacional e uma arquitetura de processador diferente daquela no computador local. Para retornar o nome da seção DDInstall para o computador local, defina esse parâmetro como NULL. Caso contrário, forneça uma estrutura SP_ALTPLATFORM e defina seus membros da seguinte maneira:

cbSize

Defina como o tamanho, em bytes, de uma estrutura SP_ALTPLATFORM_INFO.

Plataforma

Defina como VER_PLATFORM_WIN32_NT para Windows XP e versões posteriores do Windows.

MajorVersion

Não usado.

MinorVersion

não usado.

ProcessorArchitecture

Defina uma das seguintes constantes de arquitetura do processador.

Constante de arquitetura do processador Significado
PROCESSOR_ARCHITECTURE_INTEL A plataforma alternativa é uma arquitetura de processador baseada em x86.
PROCESSOR_ARCHITECTURE_IA64 A plataforma alternativa é uma arquitetura de processador baseada em Itanium.
PROCESSOR_ARCHITECTURE_AMD64 A plataforma alternativa é uma arquitetura de processador baseada em x64.
 

Reservado

Defina como zero.

[out, optional] InfSectionWithExt

Um ponteiro para um buffer de caracteres para receber o nome da seção DDInstall , sua extensão de plataforma e um terminador NULL. Esse é o nome da seção decorada que deve ser usado para instalação. Se esse parâmetro for NULL, a função retornará TRUE e definirá RequiredSize como o tamanho, em caracteres, que será necessário para retornar o nome da seção DDInstall , sua extensão de plataforma e um caractere NULL de terminação.

[in] InfSectionWithExtSize

O tamanho, em caracteres, do buffer apontado pelo parâmetro InfSectionWithExt . O comprimento máximo de um nome de seção INF terminado em NULL, em caracteres, é MAX_INF_SECTION_NAME_LENGTH.

[out, optional] RequiredSize

Um ponteiro para a variável que recebe o tamanho, em caracteres, que é necessário para retornar o nome da seção DDInstall , a extensão de plataforma e um caractere NULL de terminação.

[out, optional] Extension

Um ponteiro para uma variável que recebe um ponteiro para o caractere '.' que marca o início da extensão no buffer InfSectionWithExt . Se o buffer InfSectionWithExt não for fornecido ou for muito pequeno, esse parâmetro não será definido. Defina esse parâmetro como NULL se um ponteiro para a extensão não for necessário.

Reserved

Reservado apenas para uso interno. Deve ser definido como NULL.

Retornar valor

Se a função for bem-sucedida, ela retornará TRUE. Caso contrário, retornará FALSE. Para obter informações de erro estendidas, chame GetLastError.

Comentários

SetupDiGetActualSectionToInstallEx é uma forma estendida de SetupDiGetActualSectionToInstall. Essas funções dão suporte às extensões para nomes de seção DDInstall que são usados para especificar ações de instalação específicas do sistema operacional e específicas da arquitetura para um dispositivo. Para obter informações sobre essas extensões, consulte Criando arquivos INF para várias plataformas e sistemas operacionais.

Se você não fornecer informações alternativas de plataforma com uma chamada para SetupDiGetActualSectionToInstallEx, a função executará a mesma operação que SetupDiGetActualSectionToInstall. A última função pesquisa o nome da seção de instalação especificado usando as informações da plataforma para o computador local.

Se você fornecer informações alternativas de plataforma com uma chamada para SetupDiGetActualSectionToInstallEx, a função fará o seguinte:

  • Se você especificar uma plataforma de VER_PLATFORM_WIN32_NT, a função primeiro pesquisará no arquivo INF especificado um nome de seção de instalação decorado que corresponda ao nome, ao sistema operacional e à arquitetura do processador que você especificar. Se, por exemplo, você especificar um nome de seção de instalação do InstallSec, a função procurará um dos seguintes nomes decorados, dependendo da arquitetura do processador especificada:
    • Se você especificar a arquitetura de processador baseada em x86, a função procurará o nome decorado InstallSec.ntx86.
    • Se você especificar a arquitetura de processador baseada em x64, a função procurará o nome decorado InstallSec.ntamd64.
    • Se você especificar a arquitetura de processador baseada em Itanium, a função procurará o nome decorado InstallSec.ntia64.

    Se a função encontrar uma correspondência para o nome, o sistema operacional e a arquitetura do processador, ela encerrará a pesquisa e retornará o nome decorado correspondente. Se a função não encontrar essa correspondência, a função procurará uma seção cujo nome é InstallSec.nt. Se a função encontrar uma correspondência para InstallSec.nt, ela encerrará a pesquisa e retornará esse nome. Se a função não encontrar uma correspondência para nenhuma das pesquisas acima, ela retornará InstallSec, mas não verificará se o arquivo INF contém uma seção de instalação cujo nome é InstallSec.

Observação

O cabeçalho setupapi.h define SetupDiGetActualSectionToInstallEx como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Windows XP e versões posteriores do Windows.
Plataforma de Destino Área de Trabalho
Cabeçalho setupapi.h (inclua Setupapi.h)
Biblioteca Setupapi.lib

Confira também

Seção INF DDInstall

SetupDiGetActualSectionToInstallEx

SetupDiInstallDevice