Compartilhar via

Função SetupDiGetActualSectionToInstallExA (setupapi.h)

  • Artigo

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

Sintaxe

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

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 um seção modelos INF). O comprimento máximo do nome da seção, em caracteres, é 254.

[in, optional] AlternatePlatformInfo

Um ponteiro, se nãoNULL, para uma estrutura de 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

Definido como zero.

[out, optional] InfSectionWithExt

Um ponteiro para um buffer de caracteres para receber o DDInstall nome da seção, 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 para o tamanho, em caracteres, que é necessário para retornar o nome da seção DDInstall , sua extensão de plataforma e um caractere NULL de encerramento.

[in] InfSectionWithExtSize

O tamanho, em caracteres, do buffer apontado pelo parâmetro InfSectionWithExt. O comprimento máximo de um nome de seção INF encerrado por 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 DDInstall nome da seção, a extensão da 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 infSectionWithExt buffer não for fornecido ou for muito pequeno, esse parâmetro não será definido. Defina esse parâmetro para NULL se um ponteiro para a extensão não for necessário.

Reserved

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

Valor de retorno

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

Observações

SetupDiGetActualSectionToInstallEx é uma forma estendida de SetupDiGetActualSectionToInstall. Essas funções dão suporte às extensões para DDInstall nomes de seção 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 especificada 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 pesquisa no arquivo INF especificado um nome de seção de instalação decorado que corresponde ao nome, 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 do 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.

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito Valor
de cliente com suporte mínimo Disponível no Windows XP e versões posteriores do Windows.
da Plataforma de Destino Área de trabalho
cabeçalho setupapi.h (inclua Setupapi.h)
biblioteca Setupapi.lib

Consulte também

Seção INF DDInstall

SetupDiGetActualSectionToInstallEx

setupDiInstallDevice