Função SetupDiSelectOEMDrv (setupapi.h)
A função SetupDiSelectOEMDrv seleciona um driver para um conjunto de informações do dispositivo ou um elemento de informações de dispositivo específico que usa um caminho OEM fornecido pelo usuário.
Sintaxe
WINSETUPAPI BOOL SetupDiSelectOEMDrv(
[in, optional] HWND hwndParent,
[in] HDEVINFO DeviceInfoSet,
[in, out] PSP_DEVINFO_DATA DeviceInfoData
);
Parâmetros
[in, optional] hwndParent
Um identificador de janela que será o pai de todas as caixas de diálogo criadas durante o processamento dessa função. Esse parâmetro pode ser usado para substituir o campo hwndParent no bloco de parâmetros de instalação do elemento ou conjunto de informações do dispositivo especificado.
[in] DeviceInfoSet
Um identificador para o conjunto de informações do dispositivo para o qual selecionar um driver.
[in, out] DeviceInfoData
Um ponteiro para uma estrutura SP_DEVINFO_DATA que especifica um elemento de informações do dispositivo em DeviceInfoSet. Esse parâmetro é opcional e pode ser NULL. Se esse parâmetro for especificado, SetupDiSelectOEMDrv associará o driver selecionado ao dispositivo especificado. Se esse parâmetro for NULL, SetupDiSelectOEMDrv associará o driver selecionado à lista de drivers de classe global para DeviceInfoSet.
Valor retornado
A função retornará TRUE se for bem-sucedida. Caso contrário, ele retornará FALSE e o erro registrado poderá ser recuperado por uma chamada para GetLastError.
Comentários
SetupDiSelectOEMDrv foi projetado principalmente para selecionar um driver OEM para um dispositivo em um computador local antes de instalar o dispositivo nesse computador. Embora SetupDiSelectOEMDrv não falhe se o conjunto de informações do dispositivo for para um computador remoto, o resultado é de uso limitado porque o conjunto de informações do dispositivo não pode ser usado posteriormente com solicitações de instalação DIF_Xxx ou funções SetupDiXxx que não dão suporte a operações em um computador remoto. Em particular, o conjunto de informações do dispositivo não pode ser usado como entrada com uma solicitação de instalação DIF_INSTALLDEVICE para instalar um dispositivo em um computador remoto.
SetupDiSelectOEMDrv solicita ao usuário o caminho OEM e, em seguida, chama o instalador de classe para selecionar um driver no caminho OEM.
Requisitos
| Cliente mínimo com suporte | Disponível no Microsoft Windows 2000 e versões posteriores do Windows. |
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | setupapi.h (inclua Setupapi.h) |
| Biblioteca | Setupapi.lib |
| DLL | Setupapi.dll |