Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Web Service on Devices API (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
Dispositivi sono componenti, in genere hardware collegati alla rete. Ad esempio 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 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 sia unidirezionale che bidirezionale e la gestione degli eventi.
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 prima 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 Discovery and Metadata Exchange Message Patterns.
Indirizzamento logico e fisico
L'indirizzamento logico viene usato per identificare in modo univoco i dispositivi indipendentemente dai relativi indirizzi fisici. WS-Discovery fornisce un meccanismo per risolvere gli indirizzi logici in indirizzi fisici, consentendo la messaggistica da client a dispositivo. Un esempio è lo spazio di archiviazione collegato alla rete (NAS) che si porta con sé. 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 UUID URI. Questo identificatore non cambierà mai per il dispositivo. Quando il dispositivo è acceso, annuncerà sempre il suo indirizzo logico tramite un messaggio di WS-Discovery Hello e accetterà le richieste per convertirlo in un indirizzo fisico (in genere HTTP) tramite messaggi WS-Discovery Risolvi o Sonda. Dopo aver ottenuto un indirizzo fisico valido (indirizzo IP), viene eseguita tutta la messaggistica su tale indirizzo e WS-Discovery viene usata solo se l'indirizzo cambia, lo stato del dispositivo cambia e i client devono ricevere una notifica oppure il dispositivo diventa offline.
Creazione di applicazioni
WSDAPI fornisce uno stack SOAP DPWS generico da usare da applicazioni client e di servizio. Il generatore di codice per i Servizi Web sui Dispositivi (WsdCodeGen.exe) può essere utilizzato 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 messaggi SOAP e campi 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 ulteriori informazioni tramite le API PnP quando è necessario più di una semplice individuazione. Per altre informazioni, vedere individuazione funzioni e PnP-X.
Argomenti correlati