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:

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

Vedi anche

WdfDeviceSetPowerCapabilities

WdfPdoInitAssignRawDevice