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

Confira também

SetupDiAskForOEMDisk