Função SetupDiGetActualModelsSectionA (setupapi.h)

A função SetupDiGetActualModelsSection recupera a seção apropriada decorada modelos INF a ser usada ao instalar um dispositivo de um arquivo INF do dispositivo.

Sintaxe

WINSETUPAPI BOOL SetupDiGetActualModelsSectionA(
  [in]            PINFCONTEXT          Context,
  [in, optional]  PSP_ALTPLATFORM_INFO AlternatePlatformInfo,
  [out, optional] PSTR                 InfSectionWithExt,
  [in]            DWORD                InfSectionWithExtSize,
  [out, optional] PDWORD               RequiredSize,
                  PVOID                Reserved
);

Parâmetros

[in] Context

Um ponteiro para um contexto de arquivo INF que especifica uma entrada de de identificador de fabricante em uma seção inf manufacturer de um arquivo INF. A entrada do identificador do fabricante especifica um nome de seção modelos INF e, opcionalmente, especifica decorações de TargetOSVersion para o nome da seção modelos . Para obter informações sobre arquivos INF e um contexto de arquivo INF, consulte os tópicos do SDK da Plataforma sobre usando arquivos INF e a estrutura INFCONTEXT.

[in, optional] AlternatePlatformInfo

Um ponteiro para uma estrutura SP_ALTPLATFORM_INFO que fornece informações sobre uma arquitetura de processador e versão do Windows. O membro cbSize dessa estrutura deve ser definido como sizeof(SP_ALTPLATFORM_INFO_V2). Esse parâmetro é opcional e pode ser definido como NULL.

[out, optional] InfSectionWithExt

Um ponteiro para um buffer que recebe uma cadeia de caracteres que contém os modelos de inf decorados nome da seção e um terminador NULL. Se AlternatePlatformInfo não for fornecido, o nome da seção modelos inf decorado se aplicará à plataforma atual; caso contrário, o nome se aplica à plataforma alternativa especificada. Esse parâmetro é opcional e pode ser definido como NULL. Se esse parâmetro for NULL, a função retornará verdadeiro e definirá RequiredSize para o tamanho, em caracteres, que será necessário para retornar o nome da seção Modelos decorado e um caractere NULL de encerramento.

[in] InfSectionWithExtSize

O tamanho, em caracteres, do buffer de DecoratedModelsSection. Se DecoratedModelsSection for NULL, esse parâmetro deverá ser definido como zero.

[out, optional] RequiredSize

Um ponteiro para uma variável do tipo DWORD que recebe o tamanho, em caracteres, do buffer DecoratedModelsSection que é necessário para recuperar o nome da seção Models decorado e um caractere NULL de terminação. Esse parâmetro é opcional e pode ser definido como NULL.

Reserved

Reservado para uso interno do sistema. Esse parâmetro deve ser definido como NULL.

Valor de retorno

SetupDiGetActualModelsSection retornará verdadeiro se a operação for bem-sucedida. Caso contrário, a função retorna FALSE e o erro registrado pode ser recuperado com uma chamada para GetLastError.

Observações

SetupDiGetActualModelsSection determina quais campos TargetOSVersion na entrada de identificador do fabricante (fornecidos por Context) se aplicam à plataforma atual, se AlternatePlatformInfo não for fornecido ou a uma plataforma alternativa, se informações alternativas da plataforma forem fornecidas. SetupDiGetActualModelsSection seleciona a plataforma mais apropriada com base em todos os campos TargetOSVersion, acrescenta a cadeia de caracteres TargetOSVersion ao nome da seção modelos inf e retorna o nome da seção modelos in f decorados ao chamador. Em uma entrada do identificador do fabricante, a versão principal do sistema operacional é especificada pelo campo OSMajorVersion e a versão secundária do sistema operacional é especificada pelo campo OSMinorVersion .

Para obter informações sobre como recuperar uma seção INF DDInstall para um dispositivo, consulte SetupDiGetActualSectionToInstall.

Nota

O cabeçalho setupapi.h define SetupDiGetActualModelsSection 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 Server 2003 com Service Pack 1 (SP1) 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

SP_ALTPLATFORM_INFO

SetupDiGetActualSectionToInstall