Informazioni sui servizi Web nei dispositivi

Il servizio Web nell'API dispositivi (WSDAPI) è un'implementazione del profilo dispositivi per i servizi Web (DPWS) per Windows Vista e Windows Server 2008. DpWS vincola le specifiche dei servizi Web in modo che i client possano facilmente individuare i dispositivi. Una volta individuato un dispositivo, un client può recuperare una descrizione dei servizi ospitati nel dispositivo e usarli.

Dispositivi e servizi

I dispositivi sono componenti, in genere hardware, collegati alla rete. Gli esempi includono stampanti, fotocamere Web e sistemi video.

I dispositivi possono includere zero o più servizi. Ad esempio, un dispositivo video può includere servizi che supportano l'accensione e la disattivazione, il controllo di riproduzione, l'espulsione multimediale e lo streaming video. Il controllo Play può supportare azioni quali riproduzione, pausa, riavvolgimento e avanzamento rapido.

Individuazione e modifica di un dispositivo

WSDAPI estende il modello di Plug and Play locale consentendo a un client di individuare e accedere a un dispositivo remoto e ai servizi associati in una rete. Supporta l'individuazione, la messaggistica di controllo unidirezionale e bidirezionale e l'evento.

I dispositivi DPWS annunciano la loro presenza ed espongono servizi (se presenti) usando un indirizzo univoco e un set standardizzato di messaggi XML. I client DPWS possono usare il processo di individuazione per trovare il dispositivo, enumerare i servizi e connettersi a tali servizi per eseguire azioni specifiche.

Un client WSDAPI esegue innanzitutto una query sul dispositivo per ottenere descrizioni complete dei servizi, inclusi i tipi di servizio , ad esempio un tipo di servizio stampante o un tipo di servizio scanner. Il client controlla quindi il dispositivo chiamando i comandi definiti da un tipo di servizio, ad esempio chiamando CreatePrintJob in un dispositivo con un tipo di servizio stampante. Facoltativamente, il client può anche monitorare le modifiche dello stato in ogni servizio sottoscrivendo gli eventi che si verificano durante l'esecuzione del comando.

Per altre informazioni sui modelli di messaggistica dei dispositivi, vedere Modelli di messaggi di individuazione e scambio di metadati.

Indirizzamento logico e fisico

L'indirizzamento logico viene usato per identificare in modo univoco i dispositivi indipendenti dai rispettivi indirizzi fisici. WS-Discovery fornisce un meccanismo per risolvere gli indirizzi logici in indirizzi fisici, consentendo la messaggistica da client a dispositivo. Un esempio è l'archiviazione connessa alla rete (NAS) che si trasporta con l'utente. Se si dispone di un portatile e un NAS, il portatile dovrebbe essere in grado di riconoscere che è lo stesso dispositivo, indipendentemente dall'indirizzo fisico (indirizzo IP) ottenuto dal NAS durante lo spostamento tra subnet. A tale scopo, è necessario che il dispositivo abbia un'identità indipendente dall'indirizzo IP ottenuto; poiché i meccanismi tradizionali come DNS non sono disponibili in uno scenario di roaming normale, WS-Addressing e WS-Discovery forniscono indirizzamento logico e risoluzione come alternativa ad hoc.

Quando un dispositivo viene prodotto, viene assegnato un identificatore univoco globale, rappresentato come URI UUID. Questo identificatore non cambierà mai per il dispositivo. Quando il dispositivo è acceso, annuncia sempre il proprio indirizzo logico tramite un messaggio Hello di WS-Discovery e accetterà le richieste per convertirlo in un indirizzo fisico (in genere HTTP) tramite WS-Discovery Risolvere o probe messaggi. Una volta ottenuto un indirizzo fisico valido (indirizzo IP), viene eseguita tutta la messaggistica su tale indirizzo e WS-Discovery viene usato solo se l'indirizzo cambia, il dispositivo cambia stato e i client devono ricevere una notifica o il dispositivo passa offline.

Compilazione di applicazioni

WSDAPI fornisce uno stack SOAP DPWS generico per l'uso da parte di applicazioni client e di servizio. I servizi Web nei dispositivi generatore di codice (WsdCodeGen.exe) possono essere usati per convertire una descrizione del servizio (WSDL) in codice proxy e stub che le applicazioni possono chiamare direttamente. Questo codice generato trasforma automaticamente le chiamate di funzione e i parametri in campi SOAP e XML e quindi chiama in WSDAPI per inviare richieste al dispositivo o al client remoto.

L'individuazione delle funzioni può essere usata durante la compilazione di applicazioni WSDAPI per creare e attivare istanze di funzione restituite da PnP. Queste istanze di funzione contengono dati che possono essere usati per ottenere altre informazioni tramite le API PnP quando è necessaria una semplice individuazione. Per altre informazioni, vedere Individuazione delle funzioni e PnP-X.

Argomenti correlati

Modelli di messaggi di individuazione e scambio di metadati

Conformità delle specifiche WSDAPI

Panoramica delle interfacce WSDAPI