Função SetupDiGetActualModelsSectionW (setupapi.h)

A função SetupDiGetActualModelsSection recupera a seção modelos INF decorados apropriados a serem usados ao instalar um dispositivo de um arquivo INF do dispositivo.

Sintaxe

WINSETUPAPI BOOL SetupDiGetActualModelsSectionW(
  [in]            PINFCONTEXT          Context,
  [in, optional]  PSP_ALTPLATFORM_INFO AlternatePlatformInfo,
  [out, optional] PWSTR                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 identificador de fabricante em uma seção Fabricante inf de um arquivo INF. A entrada de identificador de fabricante especifica um nome de seção modelos INF e, opcionalmente, especifica decorações 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 como usar 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 o nome da seção modelos INF decorados e um terminador NULL. Se AlternatePlatformInfo não for fornecido, o nome da seção modelos INF decorados 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á TRUE e definirá RequiredSize como o tamanho, em caracteres, que será necessário para retornar o nome da seção Modelos decorados e um caractere NULL de terminação.

[in] InfSectionWithExtSize

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

[out, optional] RequiredSize

Um ponteiro para uma variável de tipo DWORD que recebe o tamanho, em caracteres, do buffer DecoratedModelsSection necessário para recuperar o nome da seção Modelos decorados 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.

Retornar valor

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

Comentários

SetupDiGetActualModelsSection determina quais campos TargetOSVersion na entrada do 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 INF decorados ao chamador. Em uma entrada de identificador de 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 DDInstall do INF para um dispositivo, consulte SetupDiGetActualSectionToInstall.

Observação

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 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 Server 2003 com Service Pack 1 (SP1) 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

SP_ALTPLATFORM_INFO

SetupDiGetActualSectionToInstall