Função SetupDiGetSelectedDevice (setupapi.h)

  • Artigo

A função SetupDiGetSelectedDevice recupera o elemento de informações do dispositivo selecionado em um conjunto de informações do dispositivo.

Sintaxe

WINSETUPAPI BOOL SetupDiGetSelectedDevice(
  [in]  HDEVINFO         DeviceInfoSet,
  [out] PSP_DEVINFO_DATA DeviceInfoData
);

Parâmetros

[in] DeviceInfoSet

Um identificador para o conjunto de informações do dispositivo para o qual recuperar o elemento de informações do dispositivo selecionado.

[out] DeviceInfoData

Um ponteiro para uma estrutura SP_DEVINFO_DATA que recebe informações sobre o elemento de informações do dispositivo selecionado para DeviceInfoSet. O chamador deve definir DeviceInfoData.cbSize to sizeof(SP_DEVINFO_DATA). Se um dispositivo não estiver selecionado no momento, a função falhará e uma chamada para GetLastError retornará ERROR_NO_DEVICE_SELECTED.

Retornar valor

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

Comentários

SetupDiGetSelectedDevice geralmente é usado por um assistente de instalação.

Requisitos

Requisito Valor
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

SP_DEVINFO_DATA

SetupDiSetSelectedDevice