structure WDF_DEVICE_PNP_CAPABILITIES (wdfdevice.h)

[S’applique à KMDF et UMDF]

La structure WDF_DEVICE_PNP_CAPABILITIES décrit les fonctionnalités de Plug-and-Play d’un appareil.

Syntaxe

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;

Membres

Size

Taille, en octets, de cette structure.

LockSupported

Valeur de type WDF_TRI_STATE qui indique, si elle est définie sur WdfTrue, que l’appareil peut être verrouillé dans son emplacement pour empêcher l’éjection. (Cette fonctionnalité désactive l’éjection d’un appareil à partir de son emplacement, et non l’éjection de média d’un appareil.) Pour plus d’informations sur les valeurs de type WDF_TRI_STATE, consultez la section Remarques suivante.

EjectSupported

Valeur de type WDF_TRI_STATE qui indique, si elle est définie sur WdfTrue, que l’appareil peut être éjecté de son emplacement. (Cette fonctionnalité permet d’éjecter un appareil à partir de son emplacement, et non d’éjecter le média d’un appareil.)

Removable

Valeur de type WDF_TRI_STATE qui indique, si elle est définie sur WdfTrue, que l’appareil peut être supprimé pendant l’exécution du système. Si Amovible est défini sur WdfTrue et Que SurpriseRemovalOK a la valeur WdfFalse, les utilisateurs doivent utiliser le programme Unplug ou Eject Hardware du système.

DockDevice

Valeur de type WDF_TRI_STATE qui indique, si elle est définie sur WdfTrue, que l’appareil est une station d’accueil.

UniqueID

Valeur de type WDF_TRI_STATE qui indique, si elle est définie sur WdfTrue, que l’ID de instance de l’appareil est unique à l’ensemble du système. Si UniqueID est défini sur WdfFalse, l’ID de instance est unique uniquement au bus de l’appareil. Pour plus d’informations sur instance ID, consultez Chaînes d’identification d’appareil.

SilentInstall

Valeur de type WDF_TRI_STATE qui indique, si elle est définie sur WdfTrue, que Gestionnaire de périphériques ne doit pas afficher de boîtes de dialogue pendant l’installation de l’appareil.

SurpriseRemovalOK

Valeur de type WDF_TRI_STATE qui indique, s’il est défini sur WdfTrue (et si Amovible est également défini sur WdfTrue), que les utilisateurs peuvent supprimer l’appareil sans utiliser le programme de débranchement ou d’éjection du matériel du système.

HardwareDisabled

Valeur de type WDF_TRI_STATE qui indique, si elle est définie sur WdfTrue, que l’appareil est désactivé.

NoDisplayInUI

Valeur de type WDF_TRI_STATE qui indique, si elle est définie sur WdfTrue, que Gestionnaire de périphériques ne doit pas afficher l’appareil.

Address

Adresse qui indique l’emplacement de l’appareil dans son bus.

L’interprétation de ce nombre est spécifique au bus. Si l’adresse est inconnue ou si le pilote de bus ne prend pas en charge une adresse, le pilote de bus quitte le membre Address à sa valeur par défaut de 0xFFFFFFFF (-1).

La liste suivante décrit les informations que certains pilotes de bus stockent dans le membre Address pour leurs appareils enfants :

UINumber

Nombre associé à l’appareil et qui peut être affiché dans les interfaces utilisateur. Ce nombre est généralement un numéro d’emplacement perçu par l’utilisateur, tel qu’un numéro imprimé à côté de l’emplacement sur la carte ou un autre numéro qui aide l’utilisateur à localiser l’appareil. Si UINumber est inconnu ou si la fourniture d’un nombre n’aide pas l’utilisateur à identifier l’emplacement de l’appareil, le pilote définit cette valeur sur -1.

Remarques

Plusieurs membres utilisent le type WDF_TRI_STATE . Pour ces membres, une valeur de WdfTrue indique que l’appareil prend en charge la fonctionnalité et une valeur de WdfFalse indique que ce n’est pas le cas. La valeur WdfUseDefault indique que l’infrastructure utilisera la valeur qu’un pilote plus bas dans la pile fournie. Par exemple, si un pilote de bus spécifie WdfTrue pour LockSupported et que le pilote de fonction de l’appareil spécifie WdfUseDefault, le framework stocke WdfTrue pour la fonctionnalité.

La structure WDF_DEVICE_PNP_CAPABILITIES est utilisée comme entrée dans WdfDeviceSetPnpCapabilities.

Pour initialiser une structure de WDF_DEVICE_PNP_CAPABILITIES, un pilote doit appeler WDF_DEVICE_PNP_CAPABILITIES_INIT.

Configuration requise

Voir aussi

WdfDeviceSetPowerCapabilities

WdfPdoInitAssignRawDevice