struttura WDF_DEVICE_PNP_CAPABILITIES (wdfdevice.h)
[Si applica a KMDF e UMDF]
La struttura WDF_DEVICE_PNP_CAPABILITIES descrive le funzionalità di Plug and Play di un dispositivo.
Sintassi
typedef struct _WDF_DEVICE_PNP_CAPABILITIES {
ULONG Size;
WDF_TRI_STATE LockSupported;
WDF_TRI_STATE EjectSupported;
WDF_TRI_STATE Removable;
WDF_TRI_STATE DockDevice;
WDF_TRI_STATE UniqueID;
WDF_TRI_STATE SilentInstall;
WDF_TRI_STATE SurpriseRemovalOK;
WDF_TRI_STATE HardwareDisabled;
WDF_TRI_STATE NoDisplayInUI;
ULONG Address;
ULONG UINumber;
} WDF_DEVICE_PNP_CAPABILITIES, *PWDF_DEVICE_PNP_CAPABILITIES;
Members
Size
Dimensione, in byte, della struttura.
LockSupported
Valore tipizzato WDF_TRI_STATE che indica, se impostato su WdfTrue, che il dispositivo può essere bloccato nello slot per impedire l'espulsione. Questa funzionalità disabilita l'espulsione di un dispositivo dallo slot e non l'espulsione di supporti da un dispositivo. Per altre informazioni sui valori tipizzati di WDF_TRI_STATE, vedere la sezione Osservazioni seguente.
EjectSupported
Valore WDF_TRI_STATE tipizzato che indica, se impostato su WdfTrue, che il dispositivo può essere espulso dallo slot. Questa funzionalità consente di espellere un dispositivo dallo slot, senza espellere supporti da un dispositivo.
Removable
Valore WDF_TRI_STATE tipizzato che indica, se impostato su WdfTrue, che il dispositivo può essere rimosso durante l'esecuzione del sistema. Se Removable è impostato su WdfTrue e SurpriseRemovalOK è impostato su WdfFalse, gli utenti devono usare il programma Unplug o Eject Hardware del sistema.
DockDevice
Valore tipizzato WDF_TRI_STATE che indica, se impostato su WdfTrue, che il dispositivo è una stazione di ancoraggio.
UniqueID
Valore WDF_TRI_STATE tipizzato che indica, se impostato su WdfTrue, che l'ID istanza del dispositivo è univoco per l'intero sistema. Se UniqueID è impostato su WdfFalse, l'ID istanza è univoco solo per il bus del dispositivo. Per altre informazioni sugli ID istanza, vedere Stringhe di identificazione del dispositivo.
SilentInstall
Valore WDF_TRI_STATE tipizzato che indica, se impostato su WdfTrue, che Gestione dispositivi non deve visualizzare le finestre di dialogo durante l'installazione del dispositivo.
SurpriseRemovalOK
Valore WDF_TRI_STATE tipizzato che indica se impostato su WdfTrue (e se Removable è impostato anche su WdfTrue), gli utenti possono rimuovere il dispositivo senza usare il programma Unplug o Eject Hardware del sistema.
HardwareDisabled
Valore tipizzato WDF_TRI_STATE che indica, se impostato su WdfTrue, che il dispositivo è disabilitato.
NoDisplayInUI
Valore WDF_TRI_STATE tipizzato che indica che, se impostato su WdfTrue, tale Gestione dispositivi non deve visualizzare il dispositivo.
Address
Indirizzo che indica dove si trova il dispositivo sul bus.
L'interpretazione di questo numero è specifica dell'autobus. Se l'indirizzo è sconosciuto o il driver del bus non supporta un indirizzo, il driver del bus lascia il membro Address al valore predefinito di 0xFFFFFFFF (-1).
Nell'elenco seguente vengono descritte le informazioni archiviate da determinati driver del bus nel membro Address per i dispositivi figlio:
| Bus | 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 del dispositivo nella parola alta e numero di funzione nella parola bassa. |
| SCSI | ID di destinazione. |
| USB | Il numero della porta. |
UINumber
Numero associato al dispositivo e che può essere visualizzato nelle interfacce 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 consente all'utente di individuare il dispositivo. Se UINumber è sconosciuto o se si specifica un numero non consente all'utente di identificare la posizione del dispositivo, il driver imposta questo valore su -1.
Commenti
Diversi membri usano il tipo di WDF_TRI_STATE . Per questi membri, un valore WdfTrue indica che il dispositivo supporta la funzionalità e un valore WdfFalse indica che non lo è. Il valore WdfUseDefault indica che il framework userà il valore inferiore di un driver nello stack fornito. Ad esempio, se un driver del bus specifica WdfTrue per LockSupported e il driver di funzione del dispositivo specifica WdfUseDefault, il framework archivia WdfTrue per la funzionalità.
La struttura WDF_DEVICE_PNP_CAPABILITIES viene usata come input per WdfDeviceSetPnpCapabilities.
Per inizializzare una struttura di WDF_DEVICE_PNP_CAPABILITIES, un driver deve chiamare WDF_DEVICE_PNP_CAPABILITIES_INIT.
Requisiti
| Requisito | Valore |
|---|---|
| Versione KMDF minima | 1.0 |
| Versione UMDF minima | 2,0 |
| Intestazione | wdfdevice.h (include Wdf.h) |