DEVICE_CAPABILITIES struttura (wdm.h)

Una struttura DEVICE_CAPABILITIES descrive le funzionalità di alimentazione e PnP di un dispositivo. Questa struttura viene restituita in risposta a un IRP_MN_QUERY_CAPABILITIES IRP.

Sintassi

typedef struct _DEVICE_CAPABILITIES {
  USHORT             Size;
  USHORT             Version;
  ULONG              DeviceD1 : 1;
  ULONG              DeviceD2 : 1;
  ULONG              LockSupported : 1;
  ULONG              EjectSupported : 1;
  ULONG              Removable : 1;
  ULONG              DockDevice : 1;
  ULONG              UniqueID : 1;
  ULONG              SilentInstall : 1;
  ULONG              RawDeviceOK : 1;
  ULONG              SurpriseRemovalOK : 1;
  ULONG              WakeFromD0 : 1;
  ULONG              WakeFromD1 : 1;
  ULONG              WakeFromD2 : 1;
  ULONG              WakeFromD3 : 1;
  ULONG              HardwareDisabled : 1;
  ULONG              NonDynamic : 1;
  ULONG              WarmEjectSupported : 1;
  ULONG              NoDisplayInUI : 1;
  ULONG              Reserved1 : 1;
  ULONG              WakeFromInterrupt : 1;
  ULONG              SecureDevice : 1;
  ULONG              ChildOfVgaEnabledBridge : 1;
  ULONG              DecodeIoOnBoot : 1;
  ULONG              Reserved : 9;
  ULONG              Address;
  ULONG              UINumber;
  DEVICE_POWER_STATE DeviceState[POWER_SYSTEM_MAXIMUM];
  SYSTEM_POWER_STATE SystemWake;
  DEVICE_POWER_STATE DeviceWake;
  ULONG              D1Latency;
  ULONG              D2Latency;
  ULONG              D3Latency;
} DEVICE_CAPABILITIES, *PDEVICE_CAPABILITIES;

Members

Size

Specifica le dimensioni della struttura, in byte. Questo campo viene impostato dal componente che invia la richiesta di IRP_MN_QUERY_CAPABILITIES .

Version

Specifica la versione della struttura, attualmente versione 1. Questo campo viene impostato dal componente che invia la richiesta di IRP_MN_QUERY_CAPABILITIES .

DeviceD1

Specifica se l'hardware del dispositivo supporta lo stato di alimentazione D1. I driver non devono modificare questo valore.

DeviceD2

Specifica se l'hardware del dispositivo supporta lo stato di alimentazione D2. I driver non devono modificare questo valore.

LockSupported

Specifica se il dispositivo supporta il blocco del dispositivo fisico che impedisce l'espulsione del dispositivo. Questo membro riguarda l'esezione del dispositivo dallo slot, anziché l'inserimento di un elemento di supporti rimovibili dal dispositivo.

EjectSupported

Specifica se il dispositivo supporta l'espulsione del dispositivo controllato dal software mentre il sistema si trova nello stato di PowerSystemWorking . Questo membro riguarda l'esezione del dispositivo dallo slot, anziché l'inserimento di un elemento di supporti rimovibili dal dispositivo.

Removable

Specifica se il dispositivo può essere rimosso dinamicamente dall'elemento padre immediato. Se La proprietà Rimovibile è impostata su TRUE, il dispositivo non appartiene allo stesso oggetto fisico del relativo padre.

Ad esempio, se Il dispositivo rimovibile è impostato su TRUE per un dispositivo composito USB all'interno di una stampante multifunzione, il dispositivo composito non appartiene all'oggetto fisico del relativo padre immediato, ad esempio un hub USB all'interno di un PC notebook.

Nella maggior parte dei casi il driver del bus, non il driver di funzione, deve determinare il valore del parametro rimovibile del dispositivo. Per i dispositivi USB, il driver dell'hub USB imposta il parametro Rimovibile . Non deve essere modificato dal driver di funzione.

Se Removable è impostato su TRUE, il dispositivo viene visualizzato nel programma Unplug o Eject Hardware , a meno che SurpriseRemovalOK non sia impostato anche su TRUE.

DockDevice

Specifica se il dispositivo è una periferica di ancoraggio.

UniqueID

Specifica se l'ID dell'istanza del dispositivo è univoco a livello di sistema. Questo bit è chiaro se l'ID istanza è univoco solo nell'ambito del bus. Per altre informazioni, vedere Stringhe di identificazione del dispositivo.

SilentInstall

Specifica se Gestione dispositivi deve eliminare tutte le finestre di dialogo di installazione, ad eccezione delle finestre di dialogo necessarie, ad esempio "nessun driver compatibile trovato".

RawDeviceOK

Specifica se il driver per il bus sottostante può guidare il dispositivo se non è presente alcun driver di funzione, ad esempio dispositivi SCSI in modalità pass-through. Questa modalità di operazione è denominata modalità non elaborata.

SurpriseRemovalOK

Specifica se il driver di funzione per il dispositivo può gestire il caso in cui il dispositivo viene rimosso prima che Windows possa inviare IRP_MN_QUERY_REMOVE_DEVICE a esso. Se SurpriseRemovalOK è impostato su TRUE, il dispositivo può essere rimosso in modo sicuro dal relativo padre immediato indipendentemente dallo stato in cui si trova il driver.

Ad esempio, un mouse USB standard non mantiene uno stato nel relativo hardware e quindi può essere rimosso in modo sicuro in qualsiasi momento. Tuttavia, un disco rigido esterno il cui driver memorizza nella cache le scritture in memoria non può essere rimosso in modo sicuro senza prima consentire al driver di scaricare la cache nell'hardware.

I driver per i dispositivi USB che supportano la rimozione delle sorprese devono impostare questa opzione su TRUE solo quando viene passato il backup dello stack di driver.

WakeFromD0

Specifica se il dispositivo può rispondere a un segnale di riattivazione esterno durante lo stato D0. I driver non devono modificare questo valore.

WakeFromD1

Specifica se il dispositivo può rispondere a un segnale di riattivazione esterno durante lo stato D1. I driver non devono modificare questo valore.

WakeFromD2

Specifica se il dispositivo può rispondere a un segnale di riattivazione esterno durante lo stato D2. I driver non devono modificare questo valore.

WakeFromD3

Specifica se il dispositivo può rispondere a un segnale di riattivazione esterno durante lo stato D3. I driver non devono modificare questo valore.

HardwareDisabled

Se impostato, questo flag specifica che l'hardware del dispositivo è disabilitato.

Un driver del bus padre del dispositivo o un driver di filtro del bus imposta questo flag quando un driver determina che l'hardware del dispositivo è disabilitato.

Il gestore PnP invia una IRP_MN_QUERY_CAPABILITIES IRP subito dopo l'enumerazione di un dispositivo e invia un'altra dopo l'avvio del dispositivo. Il gestore PnP controlla solo questo bit subito dopo l'enumerazione del dispositivo. Dopo l'avvio del dispositivo, questo bit viene ignorato.

NonDynamic

Riservato per usi futuri.

WarmEjectSupported

Riservato per usi futuri.

NoDisplayInUI

Non visualizzare il dispositivo nell'interfaccia utente. Se questo bit è impostato, il dispositivo non viene mai visualizzato nell'interfaccia utente, anche se il dispositivo è presente ma non viene avviato. Solo i driver del bus e i driver di filtro associati devono impostare questo bit. Vedere anche il flag di PNP_DEVICE_DONT_DISPLAY_IN_UI nella struttura PNP_DEVICE_STATE .

Reserved1

Riservato per l'utilizzo nel sistema.

WakeFromInterrupt

Indica se il driver o ACPI è responsabile della gestione dell'evento di riattivazione. Se impostato, il driver è responsabile della gestione dell'evento di riattivazione. ACPI armezza il dispositivo quando riceve un IRP_MN_WAIT_WAKE IRP, ma non connette l'interruzione, completare l'IRP per notificare lo stack di dispositivi di un evento di riattivazione.

SecureDevice

Indica se il dispositivo è un dispositivo sicuro.

ChildOfVgaEnabledBridge

Per un dispositivo VGA, indica se il bridge padre ha il set di bit di decodifica VGA.

DecodeIoOnBoot

Indica se il dispositivo ha decodificato I/O abilitato per l'avvio.

Reserved

Riservato per l'utilizzo nel sistema.

Address

Specifica un indirizzo che indica dove si trova il dispositivo sul bus sottostante.

L'interpretazione di questo numero è specifica del bus. Se l'indirizzo è sconosciuto o il driver del bus non supporta un indirizzo, il driver del bus lascia questo membro al valore predefinito di 0xFFFFFFFF.

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

UINumber

Specifica un numero associato al dispositivo che può essere visualizzato nell'interfaccia utente.

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 rende più semplice l'individuazione del dispositivo fisico per l'utente. Per gli autobus senza tale convenzione o quando uiNumber è sconosciuto, il driver del bus lascia questo membro al valore predefinito di 0xFFFFFFFF.

DeviceState[POWER_SYSTEM_MAXIMUM]

Matrice di valori che indica lo stato di alimentazione del dispositivo più alimentato che il dispositivo può mantenere per ogni stato di alimentazione del sistema. L'elemento DeviceState[PowerSystemWorking] della matrice corrisponde allo stato del sistema S0. La voce per PowerSystemUnspecified è riservata per l'uso del sistema.

Le voci in questa matrice si basano sulle funzionalità del nodo devnode padre. Come regola generale, un driver non deve modificare questi valori. Tuttavia, se necessario, un driver può abbassare il valore, ad esempio da PowerDeviceD1 a PowerDeviceD2.

Se il driver del bus non è in grado di determinare lo stato di alimentazione del dispositivo appropriato per un dispositivo enumerato radice, imposta DeviceState[PowerSystemWorking] su PowerDeviceD0 e tutte le altre voci su PowerDeviceD3.

SystemWake

Specifica lo stato di alimentazione del sistema meno alimentato da cui il dispositivo può segnalare un evento di riattivazione. Un valore di PowerSystemUnspecified indica che il dispositivo non può riattivare il sistema.

Un driver del bus può ottenere queste informazioni dal nodo devnode padre.

In generale, un driver non deve modificare questo valore. Se necessario, tuttavia, un driver può aumentare lo stato di alimentazione, ad esempio da PowerSystemHibernate a PowerSystemS1, per indicare che il dispositivo non può riattivare il sistema da uno stato di ibernazione ma può passare da uno stato di sospensione più elevato.

DeviceWake

Specifica lo stato di alimentazione del dispositivo meno alimentato da cui il dispositivo può segnalare un evento di riattivazione. Un valore di PowerDeviceUnspecified indica che il dispositivo non può segnalare un evento di riattivazione.

D1Latency

Specifica la latenza approssimativa del caso peggiore del dispositivo, in unità di 100 microsecondi, per restituire il dispositivo allo stato PowerDeviceD0 dallo stato PowerDeviceD1 . Impostare su zero se il dispositivo non supporta lo stato D1.

D2Latency

Specifica la latenza approssimativa del caso peggiore del dispositivo, in unità di 100 microsecondi, per restituire lo stato del dispositivo allo stato PowerDeviceD0 dallo stato PowerDeviceD2 . Impostare su zero se il dispositivo non supporta lo stato D2.

D3Latency

Specifica la latenza approssimativa del caso peggiore del dispositivo, in unità di 100 microsecondi, per restituire il dispositivo allo stato PowerDeviceD0 dallo stato PowerDeviceD3 . Impostare su zero se il dispositivo non supporta lo stato D3.

Commenti

I driver del bus impostano i valori appropriati in questa struttura in risposta a un IRP_MN_QUERY_CAPABILITIES IRP. Driver di filtro bus, driver di funzione e driver di filtro possono modificare le funzionalità impostate dal driver del bus.

I driver che inviano una richiesta di IRP_MN_QUERY_CAPABILITIES devono inizializzare i membri Size, Version, Address e UINumber di questa struttura prima di inviare l'IRP.

Per altre informazioni sull'uso della struttura DEVICE_CAPABILITIES per descrivere le funzionalità di alimentazione di un dispositivo, vedere Creazione di report sulle funzionalità di risparmio energia dei dispositivi.

Requisiti

Vedi anche

IRP_MN_QUERY_CAPABILITIES

PNP_DEVICE_STATE