Condividi tramite


enumerazione DEVICE_REGISTRY_PROPERTY (wdm.h)

L'enumerazione DEVICE_REGISTRY_PROPERTY identifica le proprietà del dispositivo archiviate nel Registro di sistema.

Sintassi

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;

Costanti

 
DevicePropertyDeviceDescription
Stringa che descrive il dispositivo, ad esempio "Microsoft PS/2 Port Mouse", in genere definito dal produttore. Il tipo di proprietà è una stringa WCHAR con terminazione NULL.
DevicePropertyHardwareID
ID hardware forniti dal dispositivo che identificano il dispositivo. Il tipo di proprietà è un valore REG_MULTI_SZ.
DevicePropertyCompatibleIDs
ID compatibili segnalati dal dispositivo. Il tipo di proprietà è un valore REG_MULTI_SZ.
DevicePropertyBootConfiguration
Risorse hardware assegnate al dispositivo dal firmware, in formato non elaborato. Il tipo di proprietà è una struttura CM_RESOURCE_LIST.
DevicePropertyBootConfigurationTranslated
Le risorse hardware assegnate al dispositivo dal firmware, in formato convertito. Il tipo di proprietà è una struttura CM_RESOURCE_LIST.
DevicePropertyClassName
Nome della classe di installazione del dispositivo, in formato testo. Il tipo di proprietà è una stringa WCHAR con terminazione NULL.
DevicePropertyClassGuid
GUID per la classe di installazione del dispositivo. Il tipo di proprietà è una matrice con terminazione NULL di WCHAR.

GUID in formato stringa come segue, dove ogni "c" rappresenta un carattere esadecimale: {cccccccc-cccc-cccc-cccc-cccccccccc}
DevicePropertyDriverKeyName
Nome della chiave del Registro di sistema specifica del driver. Il tipo di proprietà è una stringa WCHAR con terminazione NULL.
DevicePropertyManufacturer
Stringa che identifica il produttore del dispositivo. Il tipo di proprietà è una stringa WCHAR con terminazione NULL.
DevicePropertyFriendlyName
Stringa che può essere usata per distinguere tra due dispositivi simili, in genere definiti dal programma di installazione della classe. Il tipo di proprietà è una stringa WCHAR con terminazione NULL.
DevicePropertyLocationInformation
Informazioni sulla posizione del dispositivo sul bus; l'interpretazione di queste informazioni è specifica del bus. Il tipo di proprietà è una stringa WCHAR con terminazione NULL.
DevicePropertyPhysicalDeviceObjectName
Nome del PDO per questo dispositivo. Il tipo di proprietà è una stringa WCHAR con terminazione NULL.
DevicePropertyBusTypeGuid
GUID per il bus a cui è connesso il dispositivo. I GUID del tipo di bus definiti dal sistema sono elencati nel file di intestazione Wdmguid.h. Il tipo di proprietà è un GUID, che è una struttura a 16 byte che contiene il GUID in formato binario.
DevicePropertyLegacyBusType
Richiede il tipo di bus, ad esempio PCIBus o PCMCIABus. Il tipo di proprietà è un valore di enumerazione INTERFACE_TYPE.
DevicePropertyBusNumber
Numero di bus legacy del bus a cui è connesso il dispositivo. Il tipo di proprietà è ULONG.
DevicePropertyEnumeratorName
Nome dell'enumeratore per il dispositivo, ad esempio "PCI" o "root". Il tipo di proprietà è una stringa WCHAR con terminazione NULL.
DevicePropertyAddress
Indirizzo del dispositivo sul bus. Il tipo di proprietà è ULONG.

L'interpretazione di questo indirizzo è specifica del bus. Il chiamante di questa routine deve chiamare di nuovo la routine per richiedere il DevicePropertyBusTypeGuido eventualmente il DevicePropertyLegacyBusType, in modo che possa interpretare l'indirizzo. Un valore di indirizzo di 0xFFFFFFFF indica che l'autista del bus sottostante non ha fornito un indirizzo bus per il dispositivo.

Nell'elenco seguente vengono descritte le informazioni archiviate da determinati driver del bus per i dispositivi figlio:

Autobus Descrizione
----- -------------
1394 Non fornisce un indirizzo perché gli indirizzi sono volatili. Il valore predefinito è 0xFFFFFFFF.
EISA Numero slot (0-F).
IDE Per un dispositivo IDE, l'indirizzo contiene l'ID di destinazione e il LUN. Per un canale IDE, l'indirizzo è zero o uno (0 = canale primario e 1 = canale secondario).
ISApnp Non fornisce un indirizzo. Il valore predefinito è 0xFFFFFFFF.
Scheda PC (PCMCIA) Numero di socket (in genere 0x00 o 0x40).
PCI Numero di dispositivo nella parola alta e numero di funzione nella parola bassa.
SCSI ID di destinazione.
USB Numero di porta.
DevicePropertyUINumber
Numero associato al dispositivo che può essere visualizzato nell'interfaccia utente. Il tipo di proprietà è un valore ULONG.

Questo numero è in genere un numero di slot percepito dall'utente, ad esempio un numero stampato accanto allo slot sulla scheda o un altro numero che semplifica l'individuazione del dispositivo fisico per l'utente. Se il dispositivo si trova su un bus che non dispone di convenzioni per il numero di interfaccia utente o se il driver del bus per il dispositivo non è in grado di determinare il numero di interfaccia utente, questo valore è 0xFFFFFFFF.
DevicePropertyInstallState
Stato di installazione del dispositivo. Il tipo di proprietà è un valore di enumerazione DEVICE_INSTALL_STATE.
DevicePropertyRemovalPolicy
Criterio di rimozione corrente del dispositivo. Il sistema operativo usa questo valore come hint per determinare il modo in cui il dispositivo viene normalmente rimosso. Il tipo di proprietà è un valore di enumerazione DEVICE_REMOVAL_POLICY.
DevicePropertyResourceRequirements
DevicePropertyAllocatedResources
DevicePropertyContainerID

Fabbisogno

Requisito Valore
intestazione wdm.h (include Wdm.h, Ntddk.h, Ntifs.h, Wudfwdm.h)

Vedere anche

IoGetDeviceProperty