Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Веб-служба на устройствах API (WSDAPI) — это реализация профиля устройств для веб-служб (DPWS) для Windows Vista и Windows Server 2008. Спецификации DPWS ограничивают веб-службы так, чтобы клиенты могли легко обнаруживать устройства. После обнаружения устройства клиент может получить описание служб, размещенных на этом устройстве, и использовать эти службы.
Устройства и службы
Устройства являются компонентами, обычно оборудованием, подключенным к сети. Примерами являются принтеры, веб-камеры и видеосистемы.
Устройства могут включать ноль или более служб. Например, видеоустройство может включать службы, поддерживающие включение и отключение питания, управление воспроизведением, извлечение мультимедиа и потоковую передачу видео. Элемент управления воспроизведением может поддерживать такие действия, как воспроизведение, пауза, перемотка и быстрый вперед.
Обнаружение и управление устройством
WSDAPI расширяет локальную модель Plug and Play, позволяя клиенту обнаруживать и получать доступ к удаленному устройству и связанным службам в сети. Она поддерживает обнаружение, одностороннее и двустороннее управление сообщениями, а также событийность.
Устройства DPWS объявляют о присутствии и предоставляют службы (при наличии), используя уникальный адрес и стандартный набор XML-сообщений. Клиенты DPWS могут использовать процесс обнаружения для поиска устройства, перечисления служб и подключения к этим службам для выполнения определенных действий.
Клиент WSDAPI сначала запрашивает устройство для полного описания своих служб, включая типы служб (например, тип службы принтера или тип службы сканера). Затем клиент управляет устройством путем вызова команд, определенных типом службы (например, путем вызова CreatePrintJob на устройстве с типом службы принтера). При необходимости клиент также может отслеживать изменения состояния в каждой службе, подписавшись на события, происходящие во время выполнения команды.
Дополнительную информацию о шаблонах обмена сообщениями устройств см. в разделе «Шаблоны обмена и обнаружение метаданных».
Логическая и физическая адресация
Логическая адресация используется для уникальной идентификации устройств независимо от их физических адресов. WS-Discovery предоставляет механизм разрешения логических адресов в физические адреса, что позволяет выполнять обмен сообщениями между клиентами и устройствами. Примером является подключенное к сети хранилище (NAS), которое вы несете с собой. Если у вас есть ноутбук и NAS, ноутбук должен быть в состоянии распознать, что это то же устройство, независимо от физического адреса (IP-адреса), который ПОЛУЧАЕТ NAS при перемещении между подсетями. Для этого требуется, чтобы устройство удостоверялось независимо от получаемого IP-адреса; поскольку традиционные механизмы, такие как DNS, недоступны в обычном сценарии перемещения, WS-Addressing и WS-Discovery обеспечивают логическую адресацию и разрешение в качестве нерегламентированной альтернативы.
При изготовлении устройства он получает глобальный уникальный идентификатор, представленный как URI UUID. Этот идентификатор никогда не изменится для устройства. При включении устройства оно всегда будет объявлять свой логический адрес через сообщение WS-Discovery Hello и будет принимать запросы на преобразование этого адреса в физический (обычно HTTP) через сообщения WS-Discovery Resolve или Probe. После получения допустимого физического адреса (IP-адреса) все сообщения выполняются по такому адресу, и WS-Discovery используется только в том случае, если адрес изменяется, состояние устройства изменяется и клиенты должны быть уведомлены, или устройство переходит в автономный режим.
Создание приложений
WSDAPI предоставляет универсальный стек SOAP DPWS для использования клиентскими приложениями и приложениями службы. Веб-службы генератора кода устройств (WsdCodeGen.exe) можно использовать для преобразования описания службы (WSDL) в прокси-сервер и заглушку кода, который приложения могут вызывать напрямую. Этот созданный код автоматически преобразует вызовы функций и параметры в сообщения SOAP и xml-поля, а затем вызывает WSDAPI для выдачи запросов к удаленному устройству или клиенту.
Обнаружение функций можно использовать при создании приложений WSDAPI для создания и активации экземпляров функций, возвращаемых PnP. Эти экземпляры функций содержат данные, которые можно использовать для получения дополнительных сведений через API-интерфейсы PnP, если требуется больше, чем просто простое обнаружение. Дополнительные сведения см. в Обнаружение функций и PnP-X.
Связанные разделы