Função SetupDiGetDeviceInstanceIdA (setupapi.h)

A função SetupDiGetDeviceInstanceId recupera a ID da instância do dispositivo associada a um elemento de informações do dispositivo.

Observação

No Windows Vista e versões posteriores do Windows, o modelo de propriedade do dispositivo unificado usa a chave de propriedadeDEVPKEY_Device_InstanceId para representar o identificador da instância do dispositivo. Consulte Recuperando um identificador de instância de dispositivo para obter detalhes.

Sintaxe

WINSETUPAPI BOOL SetupDiGetDeviceInstanceIdA(
  [in]            HDEVINFO         DeviceInfoSet,
  [in]            PSP_DEVINFO_DATA DeviceInfoData,
  [out, optional] PSTR             DeviceInstanceId,
  [in]            DWORD            DeviceInstanceIdSize,
  [out, optional] PDWORD           RequiredSize
);

Parâmetros

[in] DeviceInfoSet

Um identificador para o conjunto de informações do dispositivo que contém o elemento de informações do dispositivo que representa o dispositivo para o qual recuperar uma ID de instância do dispositivo.

[in] DeviceInfoData

Um ponteiro para uma estrutura SP_DEVINFO_DATA que especifica o elemento de informações do dispositivo em DeviceInfoSet.

[out, optional] DeviceInstanceId

Um ponteiro para o buffer de caracteres que receberá a ID da instância do dispositivo terminada em NULL para o elemento de informações do dispositivo especificado. Para obter informações sobre IDs de instância do dispositivo, consulte Cadeias de caracteres de identificação do dispositivo.

[in] DeviceInstanceIdSize

O tamanho, em caracteres, do buffer DeviceInstanceId .

[out, optional] RequiredSize

Um ponteiro para a variável que recebe o número de caracteres necessários para armazenar a ID da instância do dispositivo.

Valor retornado

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

Comentários

Observação

O cabeçalho setupapi.h define SetupDiGetDeviceInstanceId como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

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

Confira também

SP_DEVINFO_DATA

SetupDiCreateDevRegKey

SetupDiCreateDeviceInfo

SetupDiOpenDevRegKey

SetupDiOpenDeviceInfo