Compartilhar via


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.

Nota

No Windows Vista e versões posteriores do Windows, o modelo de propriedade de dispositivo unificado usa a chave de propriedade DEVPKEY_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 da instância do dispositivo.

[in] DeviceInfoData

Um ponteiro para uma estrutura de 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 de retorno

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.

Observações

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito Valor
de cliente com suporte mínimo Disponível no Microsoft Windows 2000 e versões posteriores do Windows.
da Plataforma de Destino Área de trabalho
cabeçalho setupapi.h (inclua Setupapi.h)
biblioteca Setupapi.lib

Consulte também

SP_DEVINFO_DATA

SetupDiCreateDevRegKey

SetupDiCreateDeviceInfo

SetupDiOpenDevRegKey

SetupDiOpenDeviceInfo