Partilhar via


Abrir a chave de hardware de um dispositivo

Uma chave de hardware é uma subchave do Registro específica do dispositivo que contém informações sobre o dispositivo. Você não deve abrir diretamente a chave de hardware de um dispositivo. Tal como acontece com qualquer chave de registo, a localização ou o formato destas chaves pode mudar entre diferentes versões do Windows.

Observação

Você deve abrir a chave de hardware de um dispositivo somente depois que o dispositivo correspondente tiver sido encontrado. Para obter mais informações sobre este procedimento, consulte Enumerando dispositivos instalados.

Para abrir ou criar a chave de hardware de um dispositivo, siga estas diretrizes:

Observação

Você deve definir o parâmetro onde você fornece o acesso de segurança solicitado para as permissões de acesso mínimas que são necessárias. Você não deve definir esse parâmetro como KEY_ALL_ACCESS. Para obter mais informações sobre como especificar permissões de acesso para acesso ao Registro, consulte Acessando chaves do Registro com segurança.

  • Para abrir uma chave de hardware existente, use CM_Open_DevNode_Key com um Disposition of RegDisposition_OpenExisting e ulFlags contendo CM_REGISTRY_HARDWARE ou use o parâmetro SetupDiOpenDevRegKey e KeyType do DIREG_DEV.

  • Para criar uma chave de hardware, use CM_Open_DevNode_Key com Disposition de RegDisposition_OpenAlways e ulFlags contendo CM_REGISTRY_HARDWARE ou use SetupDiCreateDevRegKey com o parâmetro KeyType de DIREG_DEV.

  • Os chamadores de modo kernel devem usar IoOpenDeviceRegistryKey e definir o parâmetro DevInstKeyType como PLUGPLAY_REGKEY_DEVICE.