Interface IWDFDevice (wudfddi.h)
[Avertissement : UMDF 2 est la dernière version d’UMDF et remplace UMDF 1. Tous les nouveaux pilotes UMDF doivent être écrits à l’aide d’UMDF 2. Aucune nouvelle fonctionnalité n’est ajoutée à UMDF 1 et la prise en charge d’UMDF 1 est limitée sur les versions plus récentes de Windows 10. Les pilotes Windows universels doivent utiliser UMDF 2. Pour plus d’informations, consultez Prise en main avec UMDF.]
L’interface IWDFDevice expose un objet d’appareil, qui est une représentation d’un appareil sur le système.
Héritage
L’interface IWDFDevice hérite d’IWDFObject. IWDFDevice possède également les types de membres suivants :
- Méthodes
Méthodes
L’interface IWDFDevice possède ces méthodes.
| IWDFDevice ::AssignDeviceInterfaceState La méthode AssignDeviceInterfaceState active ou désactive l’interface d’appareil spécifiée instance pour un appareil. |
| IWDFDevice ::CommitPnpState La méthode CommitPnpState valide l’état de la propriété Plug-and-Play (PnP) (c’est-à-dire, active, désactive ou définit l’état par défaut) défini par la méthode IWDFDevice ::SetPnpState. |
| IWDFDevice ::ConfigureRequestDispatching La méthode ConfigureRequestDispatching configure la mise en file d’attente des demandes d’E/S du type spécifié dans la file d’attente d’E/S spécifiée. |
| IWDFDevice ::CreateDeviceInterface La méthode CreateDeviceInterface crée un instance d’une classe d’interface d’appareil. |
| IWDFDevice ::CreateIoQueue La méthode CreateIoQueue configure la file d’attente d’E/S par défaut associée à un appareil ou crée une file d’attente d’E/S secondaire pour l’appareil. |
| IWDFDevice ::CreateRequest La méthode CreateRequest crée un objet de requête non mis en forme. |
| IWDFDevice ::CreateSymbolicLink La méthode CreateSymbolicLink crée un lien symbolique pour l’appareil. |
| IWDFDevice ::CreateWdfFile La méthode CreateWdfFile crée un objet file pour un pilote à utiliser. |
| IWDFDevice ::GetDefaultIoQueue La méthode GetDefaultIoQueue récupère l’interface de la file d’attente d’E/S par défaut pour un appareil. |
| IWDFDevice ::GetDefaultIoTarget La méthode GetDefaultIoTarget récupère l’interface de la cible d’E/S par défaut pour un appareil instance. |
| IWDFDevice ::GetDriver La méthode GetDriver récupère l’interface de l’objet pilote parent d’un appareil instance. |
| IWDFDevice ::GetPnpState La méthode GetPnpState détermine si la propriété Plug-and-Play (PnP) donnée d’un appareil est activée ou désactivée (ou si l’état par défaut est défini). |
| IWDFDevice ::P ostEvent La méthode PostEvent avertit de manière asynchrone les applications qui attendent l’événement spécifié à partir d’un pilote. |
| IWDFDevice ::RetrieveDeviceInstanceId La méthode RetrieveDeviceInstanceId récupère l’identificateur d’un instance d’un appareil. |
| IWDFDevice ::RetrieveDeviceName La méthode RetrieveDeviceName récupère le nom d’un appareil en mode noyau sous-jacent. |
| IWDFDevice ::RetrieveDevicePropertyStore La méthode RetrieveDevicePropertyStore récupère une interface de magasin de propriétés. Les pilotes peuvent utiliser la méthode pour accéder au Registre. |
| IWDFDevice ::SetPnpState La méthode SetPnpState active ou désactive (ou définit l’état par défaut) la propriété Plug-and-Play (PnP) spécifiée d’un appareil. |
Remarques
Chaque objet d’appareil a un objet pilote parent. Lorsqu’un nouvel appareil arrive dans le système, l’infrastructure appelle la fonction de rappel IDriverEntry ::OnDeviceAdd du pilote parent pour informer le pilote de l’arrivée. Le pilote peut ensuite appeler la méthode IWDFDriver ::CreateDevice pour recevoir un pointeur vers l’interface IWDFDevice pour le nouvel objet d’appareil.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Fin de la prise en charge | Non disponible dans UMDF 2.0 et versions ultérieures. |
| Plateforme cible | Desktop (Expérience utilisateur) |
| Version UMDF minimale | 1.5 |
| En-tête | wudfddi.h (inclure Wudfddi.h) |