Compartilhar via


enumeração DEVICE_REGISTRY_PROPERTY (wdm.h)

A enumeração DEVICE_REGISTRY_PROPERTY identifica as propriedades do dispositivo armazenadas no registro.

Sintaxe

typedef enum {
  DevicePropertyDeviceDescription,
  DevicePropertyHardwareID,
  DevicePropertyCompatibleIDs,
  DevicePropertyBootConfiguration,
  DevicePropertyBootConfigurationTranslated,
  DevicePropertyClassName,
  DevicePropertyClassGuid,
  DevicePropertyDriverKeyName,
  DevicePropertyManufacturer,
  DevicePropertyFriendlyName,
  DevicePropertyLocationInformation,
  DevicePropertyPhysicalDeviceObjectName,
  DevicePropertyBusTypeGuid,
  DevicePropertyLegacyBusType,
  DevicePropertyBusNumber,
  DevicePropertyEnumeratorName,
  DevicePropertyAddress,
  DevicePropertyUINumber,
  DevicePropertyInstallState,
  DevicePropertyRemovalPolicy,
  DevicePropertyResourceRequirements,
  DevicePropertyAllocatedResources,
  DevicePropertyContainerID
} DEVICE_REGISTRY_PROPERTY;

Constantes

 
DevicePropertyDeviceDescription
Cadeia de caracteres que descreve o dispositivo, como "Microsoft PS/2 Port Mouse", normalmente definido pelo fabricante. O tipo de propriedade é uma cadeia de caracteres WCHAR terminada em NULL.
DevicePropertyHardwareID
IDs de hardware fornecidas pelo dispositivo que identificam o dispositivo. O tipo de propriedade é um valor REG_MULTI_SZ.
DevicePropertyCompatibleIDs
IDs compatíveis relatadas pelo dispositivo. O tipo de propriedade é um valor REG_MULTI_SZ.
DevicePropertyBootConfiguration
Recursos de hardware atribuídos ao dispositivo pelo firmware, em forma bruta. O tipo de propriedade é uma estrutura CM_RESOURCE_LIST.
DevicePropertyBootConfigurationTranslated
Os recursos de hardware atribuídos ao dispositivo pelo firmware, na forma traduzida. O tipo de propriedade é uma estrutura CM_RESOURCE_LIST.
DevicePropertyClassName
Nome da classe de instalação do dispositivo, em formato de texto. O tipo de propriedade é uma cadeia de caracteres WCHAR terminada em NULL.
DevicePropertyClassGuid
GUID para a classe de instalação do dispositivo. O tipo de propriedade é uma matriz terminada em NULL do WCHAR.

O GUID em um formato de cadeia de caracteres da seguinte maneira, em que cada "c" representa um caractere hexadecimal: {cccccccc-cccc-cccc-cccccccccc}
DevicePropertyDriverKeyName
Nome da chave do Registro específica do driver. O tipo de propriedade é uma cadeia de caracteres WCHAR terminada em NULL.
DevicePropertyManufacturer
Cadeia de caracteres que identifica o fabricante do dispositivo. O tipo de propriedade é uma cadeia de caracteres WCHAR terminada em NULL.
DevicePropertyFriendlyName
Cadeia de caracteres que pode ser usada para distinguir entre dois dispositivos semelhantes, normalmente definidos pelo instalador de classe. O tipo de propriedade é uma cadeia de caracteres WCHAR terminada em NULL.
DevicePropertyLocationInformation
Informações sobre a localização do dispositivo no barramento; a interpretação dessas informações é específica do barramento. O tipo de propriedade é uma cadeia de caracteres WCHAR terminada em NULL.
DevicePropertyPhysicalDeviceObjectName
Nome do PDO para este dispositivo. O tipo de propriedade é uma cadeia de caracteres WCHAR terminada em NULL.
DevicePropertyBusTypeGuid
GUID para o barramento ao qual o dispositivo está conectado. Os GUIDs do tipo de barramento definido pelo sistema são listados no arquivo de cabeçalho Wdmguid.h. O tipo de propriedade é um GUID, que é uma estrutura de 16 bytes que contém o GUID em formato binário.
DevicePropertyLegacyBusType
Solicita o tipo de barramento, como PCIBus ou PCMCIABus. O tipo de propriedade é um valor de enumeração INTERFACE_TYPE.
DevicePropertyBusNumber
Número do barramento herdado ao qual o dispositivo está conectado. O tipo de propriedade é um ULONG.
DevicePropertyEnumeratorName
Nome do enumerador para o dispositivo, como "PCI" ou "raiz". O tipo de propriedade é uma cadeia de caracteres WCHAR terminada em NULL.
DevicePropertyAddress
Endereço do dispositivo no barramento. O tipo de propriedade é um ULONG.

A interpretação desse endereço é específica do barramento. O chamador dessa rotina deve chamar a rotina novamente para solicitar o DevicePropertyBusTypeGuid, ou possivelmente o DevicePropertyLegacyBusType, para que ele possa interpretar o endereço. Um valor de endereço de 0xFFFFFFFF indica que o motorista do ônibus subjacente não forneceu um endereço de ônibus para o dispositivo.

A lista a seguir descreve as informações que determinados motoristas de ônibus armazenam para seus dispositivos filho:

Autocarro Descrição
----- -------------
1394 Não fornece um endereço porque os endereços são voláteis. O padrão é 0xFFFFFFFF.
EISA Número do slot (0-F).
IDE Para um dispositivo IDE, o endereço contém a ID de destino e o LUN. Para um canal IDE, o endereço é zero ou um (0 = canal primário e 1 = canal secundário).
ISApnp Não fornece um endereço. O padrão é 0xFFFFFFFF.
PC Card (PCMCIA) O número do soquete (normalmente 0x00 ou 0x40).
PCI O número do dispositivo na palavra alta e o número da função na palavra baixa.
SCSI A ID de destino.
USB O número da porta.
DevicePropertyUINumber
Número associado ao dispositivo que pode ser exibido na interface do usuário. O tipo de propriedade é um valor ULONG.

Esse número normalmente é um número de slot percebido pelo usuário, como um número impresso ao lado do slot na placa ou algum outro número que facilita a localização do dispositivo físico para o usuário. Se o dispositivo estiver em um barramento sem convenção de número de interface do usuário ou se o driver de ônibus do dispositivo não puder determinar o número da interface do usuário, esse valor será 0xFFFFFFFF.
DevicePropertyInstallState
Estado de instalação do dispositivo. O tipo de propriedade é um valor de enumeração DEVICE_INSTALL_STATE.
DevicePropertyRemovalPolicy
Política de remoção atual do dispositivo. O sistema operacional usa esse valor como uma dica para determinar como o dispositivo é normalmente removido. O tipo de propriedade é um valor de enumeração DEVICE_REMOVAL_POLICY.
DevicePropertyResourceRequirements
DevicePropertyAllocatedResources
DevicePropertyContainerID

Requisitos

Requisito Valor
cabeçalho wdm.h (incluem Wdm.h, Ntddk.h, Ntifs.h, Wudfwdm.h)

Consulte também

IoGetDeviceProperty