Função SetupDiGetDeviceRegistryPropertyA (setupapi.h)
A função SetupDiGetDeviceRegistryProperty recupera uma propriedade de dispositivo Plug and Play especificada.
Sintaxe
WINSETUPAPI BOOL SetupDiGetDeviceRegistryPropertyA(
[in] HDEVINFO DeviceInfoSet,
[in] PSP_DEVINFO_DATA DeviceInfoData,
[in] DWORD Property,
[out, optional] PDWORD PropertyRegDataType,
[out, optional] PBYTE PropertyBuffer,
[in] DWORD PropertyBufferSize,
[out, optional] PDWORD RequiredSize
);
Parâmetros
[in] DeviceInfoSet
Um identificador para um conjunto de informações do dispositivo que contém um elemento de informações do dispositivo que representa o dispositivo para o qual recuperar uma propriedade Plug and Play.
[in] DeviceInfoData
Um ponteiro para uma estrutura de SP_DEVINFO_DATA que especifica o elemento de informações do dispositivo em deviceInfoSet.
[in] Property
Um dos seguintes valores que especifica a propriedade a ser recuperada:
SPDRP_ADDRESS
A função recupera o endereço do dispositivo.
SPDRP_BUSNUMBER
A função recupera o número do barramento do dispositivo.
SPDRP_BUSTYPEGUID
A função recupera o GUID para o tipo de barramento do dispositivo.
SPDRP_CAPABILITIES
A função recupera um OR bit a bit dos seguintes sinalizadores de xxx CM_DEVCAP_
| sinalizador CM_DEVCAP_Xxx | Membro da estrutura DEVICE_CAPABILITIES correspondente |
|---|---|
| CM_DEVCAP_LOCKSUPPORTED |
|
| CM_DEVCAP_EJECTSUPPORTED | de ejetos com suporte |
| CM_DEVCAP_REMOVABLE | removível |
| CM_DEVCAP_DOCKDEVICE | DockDevice |
| CM_DEVCAP_UNIQUEID | UniqueID |
| CM_DEVCAP_SILENTINSTALL | SilentInstall |
| CM_DEVCAP_RAWDEVICEOK | RawDeviceOK |
| CM_DEVCAP_SURPRISEREMOVALOK |
SurpriseRemovalOK |
| CM_DEVCAP_HARDWAREDISABLED | hardwaredisabled |
| CM_DEVCAP_NONDYNAMIC | nãodinâmico |
SPDRP_CHARACTERISTICS
A função recupera um OR bit a bit dos sinalizadores de características de um dispositivo em um DWORD. Para obter uma descrição desses sinalizadores, que são definidos em Wdm.h e Ntddk.h, consulte o parâmetro DeviceCharacteristics da função IoCreateDevice.
SPDRP_CLASS
A função recupera uma cadeia de caracteres REG_SZ que contém a classe de instalação do dispositivo de um dispositivo.
SPDRP_CLASSGUID
A função recupera um REG_SZ cadeia de caracteres que contém o GUID que representa a classe de configuração do dispositivo de um dispositivo.
SPDRP_COMPATIBLEIDS
A função recupera uma cadeia de caracteres REG_MULTI_SZ que contém a lista de IDs compatíveis para um dispositivo. Para obter informações sobre IDs compatíveis, consulte cadeias de caracteres de identificação do dispositivo.
SPDRP_CONFIGFLAGS
A função recupera um OR bit a bit dos sinalizadores de configuração de um dispositivo em um valor DWORD. Os sinalizadores de configuração são representados pelas máscaras de bits xxx CONFIGFLAG_
SPDRP_DEVICE_POWER_DATA
(Windows XP e posterior) A função recupera uma estrutura CM_POWER_DATA que contém as informações de gerenciamento de energia do dispositivo.
SPDRP_DEVICEDESC
A função recupera uma cadeia de caracteres REG_SZ que contém a descrição de um dispositivo.
SPDRP_DEVTYPE
A função recupera um valor DWORD que representa o tipo do dispositivo. Para obter mais informações, consulte Especificando tipos de dispositivo.
SPDRP_DRIVER
A função recupera uma cadeia de caracteres que identifica a chave de software do dispositivo (às vezes chamada de chave de driver ). Para obter mais informações sobre chaves de driver, consulte Árvores e Chaves do Registro para Dispositivos e Drivers.
SPDRP_ENUMERATOR_NAME
A função recupera uma cadeia de caracteres REG_SZ que contém o nome do enumerador do dispositivo.
SPDRP_EXCLUSIVE
A função recupera um valor DWORD que indica se um usuário pode obter o uso exclusivo do dispositivo. O valor retornado será um se o uso exclusivo for permitido ou zero caso contrário. Para obter mais informações, consulte IoCreateDevice.
SPDRP_FRIENDLYNAME
A função recupera uma cadeia de caracteres REG_SZ que contém o nome amigável de um dispositivo.
SPDRP_HARDWAREID
A função recupera uma cadeia de caracteres REG_MULTI_SZ que contém a lista de IDs de hardware de um dispositivo. Para obter informações sobre IDs de hardware, consulte cadeias de caracteres de identificação do dispositivo.
SPDRP_INSTALL_STATE
(Windows XP e posterior) A função recupera um valor DWORD que indica o estado de instalação de um dispositivo. O estado de instalação é representado por um dos valores de xxx CM_INSTALL_STATE_
SPDRP_LEGACYBUSTYPE
A função recupera o tipo de barramento herdado do dispositivo como um valor INTERFACE_TYPE (definido em Wdm.h e Ntddk.h).
SPDRP_LOCATION_INFORMATION
A função recupera um REG_SZ cadeia de caracteres que contém o local de hardware de um dispositivo.
SPDRP_LOCATION_PATHS
(Windows Server 2003 e posterior) A função recupera um REG_MULTI_SZ cadeia de caracteres que representa o local do dispositivo na árvore do dispositivo.
SPDRP_LOWERFILTERS
A função recupera uma cadeia de caracteres REG_MULTI_SZ que contém os nomes dos drivers de filtro inferior de um dispositivo.
SPDRP_MFG
A função recupera um REG_SZ cadeia de caracteres que contém o nome do fabricante do dispositivo.
SPDRP_PHYSICAL_DEVICE_OBJECT_NAME
A função recupera uma cadeia de caracteres REG_SZ que contém o nome associado ao PDO do dispositivo. Para obter mais informações, consulte IoCreateDevice.
SPDRP_REMOVAL_POLICY
(Windows XP e posterior) A função recupera a política de remoção atual do dispositivo como um DWORD que contém um dos valores de xxx CM_REMOVAL_POLICY_
SPDRP_REMOVAL_POLICY_HW_DEFAULT
(Windows XP e posterior) A função recupera a política de remoção padrão especificada por hardware do dispositivo como um DWORD que contém um dos valores de xxx CM_REMOVAL_POLICY_
SPDRP_REMOVAL_POLICY_OVERRIDE
(Windows XP e posterior) A função recupera a política de remoção de substituição do dispositivo (se existir) do registro, como um DWORD que contém um dos valores CM_REMOVAL_POLICY_xxx definidos em Cfgmgr32.h.
SPDRP_SECURITY
A função recupera uma estrutura SECURITY_DESCRIPTOR para um dispositivo.
SPDRP_SECURITY_SDS
A função recupera uma cadeia de caracteres REG_SZ que contém o descritor de segurança do dispositivo. Para obter informações sobre cadeias de caracteres de descritor de segurança, consulte de Linguagem de Definição do Descritor de Segurança (Windows). Para obter informações sobre o formato de cadeias de caracteres de descritor de segurança, consulte a Linguagem de Definição do Descritor de Segurança (Windows).
SPDRP_SERVICE
A função recupera uma cadeia de caracteres REG_SZ que contém o nome do serviço de um dispositivo.
SPDRP_UI_NUMBER
A função recupera um valor DWORD definido como o valor do UINumber membro da estrutura DEVICE_CAPABILITIES do dispositivo.
SPDRP_UI_NUMBER_DESC_FORMAT
A função recupera uma cadeia de caracteres de formato (REG_SZ) usada para exibir o valor de
SPDRP_UPPERFILTERS
A função recupera uma cadeia de caracteres REG_MULTI_SZ que contém os nomes dos drivers de filtro superior de um dispositivo.
[out, optional] PropertyRegDataType
Um ponteiro para uma variável que recebe o tipo de dados da propriedade que está sendo recuperada. Esse é um dos tipos de dados padrão do Registro. Esse parâmetro é opcional e pode ser NULL.
[out, optional] PropertyBuffer
Um ponteiro para um buffer que recebe a propriedade que está sendo recuperada. Se esse parâmetro estiver definido como NULL e PropertyBufferSize também estiver definido como zero, a função retornará o tamanho necessário para o buffer em RequiredSize.
[in] PropertyBufferSize
O tamanho, em bytes, do buffer PropertyBuffer .
[out, optional] RequiredSize
Um ponteiro para uma variável do tipo DWORD que recebe o tamanho necessário, em bytes, do PropertyBuffer buffer necessário para armazenar os dados da propriedade solicitada. Esse parâmetro é opcional e pode ser NULL.
Valor de retorno
SetupDiGetDeviceRegistryProperty retornará TRUE se a chamada tiver sido bem-sucedida. Caso contrário, ele retornará FALSE e o erro registrado poderá ser recuperado fazendo uma chamada para GetLastError. SetupDiGetDeviceRegistryProperty retornará o código de erro ERROR_INVALID_DATA se a propriedade solicitada não existir para um dispositivo ou se os dados da propriedade não forem válidos.
Observações
Nota
O cabeçalho setupapi.h define SetupDiGetDeviceRegistryProperty 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 |
DesktopPara universal, chame CM_Get_DevNode_Registry_Property |
| cabeçalho | setupapi.h (inclua Setupapi.h) |
| biblioteca | Setupapi.lib |
Consulte também
SetupDiGetClassRegistryProperty