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.

Requisitos

Confira também

Seção INF DDInstall

SP_ALTPLATFORM_INFO

SetupDiGetActualSectionToInstall