Função SetupDiGetDeviceInstanceIdW (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 SetupDiGetDeviceInstanceIdW(
  [in]            HDEVINFO         DeviceInfoSet,
  [in]            PSP_DEVINFO_DATA DeviceInfoData,
  [out, optional] PWSTR            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.

Retornar valor

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

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

Confira também

SP_DEVINFO_DATA

SetupDiCreateDevRegKey

SetupDiCreateDeviceInfo

SetupDiOpenDevRegKey

SetupDiOpenDeviceInfo