À propos des services web sur les appareils
L’API Service web sur les appareils (WSDAPI) est une implémentation du profil d’appareils pour les services web (DPWS) pour Windows Vista et Windows Server 2008. Le DPWS limite les spécifications des services web afin que les clients puissent facilement découvrir les appareils. Une fois qu’un appareil est découvert, un client peut récupérer une description des services hébergés sur cet appareil et utiliser ces services.
Appareils et services
Les appareils sont des composants, généralement du matériel, qui sont attachés au réseau. Les imprimantes, les caméras web et les systèmes vidéo en sont des exemples.
Les appareils peuvent inclure zéro ou plusieurs services. Par exemple, un appareil vidéo peut inclure des services qui prennent en charge l’alimentation et l’arrêt, le contrôle de lecture, l’éjection multimédia et le streaming vidéo. Le contrôle de lecture peut prendre en charge des actions telles que la lecture, la pause, le rembobinage et l’avance rapide.
Découverte et manipulation d’un appareil
WSDAPI étend le modèle de Plug-and-Play local en permettant à un client de découvrir et d’accéder à un appareil distant et à ses services associés sur un réseau. Il prend en charge la découverte, la messagerie de contrôle unidirectionnelle et bidirectionnelle et les événements.
Les appareils DPWS annoncent leur présence et exposent les services (le cas échéant) à l’aide d’une adresse unique et d’un ensemble standardisé de messages XML. Les clients DPWS peuvent utiliser le processus de découverte pour rechercher l’appareil, énumérer ses services et se connecter à ces services pour effectuer des actions spécifiques.
Un client WSDAPI interroge d’abord l’appareil pour obtenir des descriptions complètes de ses services, y compris les types de service (par exemple, un type de service d’imprimante ou un type de service scanneur). Le client contrôle ensuite l’appareil en appelant des commandes définies par un type de service (par exemple, en appelant CreatePrintJob sur un appareil avec un type de service d’imprimante). Si vous le souhaitez, le client peut également surveiller les changements d’état dans chaque service en s’abonnant aux événements qui se produisent pendant l’exécution de la commande.
Pour plus d’informations sur les modèles de messagerie d’appareil, consultez Modèles de message d’échange de métadonnées et de découverte.
Adressage logique et physique
L’adressage logique est utilisé pour identifier de manière unique les appareils indépendamment de leurs adresses physiques. WS-Discovery fournit un mécanisme permettant de résoudre les adresses logiques en adresses physiques, ce qui permet la messagerie client à appareil. Par exemple, le stockage nas (Network Attached Storage) que vous transportez avec vous. Si vous disposez d’un ordinateur portable et d’un NAS, votre ordinateur portable doit être en mesure de reconnaître qu’il s’agit du même appareil, quelle que soit l’adresse physique (adresse IP) obtenue par le NAS lorsque vous vous déplacez entre les sous-réseaux. Pour ce faire, l’appareil doit disposer d’une identité indépendante de l’adresse IP qu’il obtient . Étant donné que les mécanismes traditionnels comme DNS ne sont pas disponibles dans un scénario d’itinérance normal, WS-Addressing et WS-Discovery fournissent un adressage logique et une résolution en tant qu’alternative ad hoc.
Lorsqu’un appareil est fabriqué, un identificateur global unique lui est attribué, représenté sous la forme d’un URI UUID. Cet identificateur ne change jamais pour l’appareil. Lorsque l’appareil est sous tension, il annonce toujours son adresse logique via un message WS-Discovery Hello et accepte les demandes de conversion en adresse physique (généralement HTTP) via WS-Discovery messages Resolve ou Probe . Une fois qu’une adresse physique valide (adresse IP) est obtenue, toute la messagerie se produit sur cette adresse et WS-Discovery est utilisé uniquement si l’adresse change, si l’appareil change d’état et que les clients doivent être avertis, ou si l’appareil passe hors connexion.
Création d’applications
WSDAPI fournit une pile SOAP DPWS générique pour une utilisation par les applications clientes et de service. Web Services on Devices Code Generator (WsdCodeGen.exe) peut être utilisé pour convertir une description de service (WSDL) en code proxy et stub que les applications peuvent appeler directement. Ce code généré transforme automatiquement les appels de fonction et les paramètres en messages SOAP et en champs XML, puis en WSDAPI pour émettre des requêtes à l’appareil ou au client distant.
La découverte de fonctions peut être utilisée lors de la création d’applications WSDAPI pour créer et activer des instances de fonction retournées par PnP. Ces instances de fonction contiennent des données qui peuvent être utilisées pour obtenir plus d’informations via les API PnP lorsque la simple découverte est nécessaire. Pour plus d’informations, consultez Découverte de fonctions et PnP-X.
Rubriques connexes