Função SetupDiSetSelectedDriverA (setupapi.h)

Artigo
11/20/2024

O SetupDiSetSelectedDriver conjuntos de funções ou redefinições, o driver selecionado para um elemento de informações do dispositivo ou o driver de classe selecionado para um conjunto de informações do dispositivo.

Sintaxe

WINSETUPAPI BOOL SetupDiSetSelectedDriverA(
  [in]      HDEVINFO           DeviceInfoSet,
  [in, out] PSP_DEVINFO_DATA   DeviceInfoData,
  [in, out] PSP_DRVINFO_DATA_A DriverInfoData
);

Parâmetros

[in] DeviceInfoSet

Um identificador para o conjunto de informações do dispositivo que contém a lista de driver da qual selecionar um driver para um elemento de informações do dispositivo ou para o conjunto de informações do dispositivo.

[in, out] DeviceInfoData

Um ponteiro para uma estrutura de SP_DEVINFO_DATA que especifica o elemento de informações do dispositivo em deviceInfoSet. Esse parâmetro é opcional e pode ser NULL. Se esse parâmetro for especificado, SetupDiSetSelectedDriver conjuntos ou redefinições, o driver selecionado para o dispositivo especificado. Se esse parâmetro for NULL, conjuntos de SetupDiSetSelectedDriver ou redefinições, o driver de classe selecionado para DeviceInfoSet.

[in, out] DriverInfoData

Um ponteiro para uma estrutura de SP_DRVINFO_DATA que especifica o driver a ser selecionado. Esse parâmetro é opcional e pode ser NULL. Se esse parâmetro e DeviceInfoData forem fornecidos, o driver especificado deverá ser membro de uma lista de driver associada a DeviceInfoData. Se esse parâmetro for especificado e DeviceInfoData for NULL, o driver deverá ser membro da lista de driver de classe global para DeviceInfoSet. Se esse parâmetro for NULL, o driver selecionado será redefinido para o elemento de informações do dispositivo, se DeviceInfoData for especificado ou o conjunto de informações do dispositivo, se DeviceInfoData estiver NULL.

Se o DriverInfoData. Reservada é NULL, o chamador está solicitando uma pesquisa por um nó de driver com os parâmetros especificados (DriverType, Descriptione ProviderName). Se uma correspondência for encontrada, esse nó de driver será selecionado. O campo Reservado é atualizado na saída para refletir o nó de driver real em que a correspondência foi encontrada. Se uma correspondência não for encontrada, a função falhará e uma chamada para GetLastError retornará ERROR_INVALID_PARAMETER.

Valor de retorno

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

Observações

Se o chamador de SetupDiSetSelectedDriver for um membro do grupo Administradores, a classe do dispositivo será definida como a classe do driver selecionado, desde que as duas classes sejam diferentes.

Se DriverInfoData for NULL, SetupDiSetSelectedDriver redefinirá o driver selecionado. Como resultado, não há nenhum driver selecionado.

Nota

O cabeçalho setupapi.h define SetupDiSetSelectedDriver 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 Microsoft Windows 2000 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

setupDiGetSelectedDriver

Compartilhar via