디바이스의 웹 서비스 정보

WSDAPI(Web Service on Devices API)는 Windows Vista 및 Windows Server 2008용 DPWS( 디바이스 프로필 for Web Services )의 구현입니다. DPWS는 클라이언트가 디바이스를 쉽게 검색할 수 있도록 웹 서비스 사양을 제한합니다. 디바이스가 검색되면 클라이언트는 해당 디바이스에서 호스트되는 서비스에 대한 설명을 검색하고 해당 서비스를 사용할 수 있습니다.

디바이스 및 서비스

디바이스 는 일반적으로 네트워크에 연결된 구성 요소(일반적으로 하드웨어)입니다. 예를 들어 프린터, 웹 카메라 및 비디오 시스템이 있습니다.

디바이스에는 0개 이상의 서비스가 포함될 수 있습니다. 예를 들어 비디오 디바이스에는 전원 켜기 및 끄기, 재생 제어, 미디어 배출 및 비디오 스트리밍을 지원하는 서비스가 포함될 수 있습니다. 재생 컨트롤은 재생, 일시 중지, 되감기 및 빨리 감기와 같은 작업을 지원할 수 있습니다.

디바이스 검색 및 조작

WSDAPI는 클라이언트가 네트워크를 통해 원격 디바이스 및 연결된 서비스를 검색하고 액세스할 수 있도록 하여 로컬 플러그 앤 플레이 모델을 확장합니다. 검색, 단방향 및 양방향 제어 메시징 및 이벤트를 지원합니다.

DPWS 디바이스는 고유한 주소와 표준화된 XML 메시지 집합을 사용하여 현재 상태를 알리고 서비스(있는 경우)를 노출합니다. DPWS 클라이언트는 검색 프로세스를 사용하여 디바이스를 찾고, 서비스를 열거하고, 해당 서비스에 연결하여 특정 작업을 수행할 수 있습니다.

WSDAPI 클라이언트는 먼저 서비스 유형(예: 프린터 서비스 유형 또는 스캐너 서비스 유형)을 포함하여 해당 서비스에 대한 전체 설명을 디바이스에 쿼리합니다. 그런 다음 클라이언트는 서비스 유형으로 정의된 명령을 호출하여 디바이스를 제어합니다(예: 프린터 서비스 유형이 있는 디바이스에서 CreatePrintJob 호출). 필요에 따라 클라이언트는 명령 실행 중에 발생하는 이벤트를 구독하여 각 서비스의 상태 변경을 모니터링할 수도 있습니다.

디바이스 메시징 패턴에 대한 자세한 내용은 검색 및 메타데이터 Exchange 메시지 패턴을 참조하세요.

논리적 및 물리적 주소 지정

논리적 주소 지정은 물리적 주소와 관계없이 디바이스를 고유하게 식별하는 데 사용됩니다. WS-Discovery 논리적 주소를 물리적 주소로 resolve 메커니즘을 제공하여 클라이언트-디바이스 메시징이 수행되도록 합니다. 예를 들어 사용자가 가지고 다니는 NAS(네트워크 연결 스토리지)가 있습니다. 노트북과 NAS가 있는 경우 서브넷 간에 이동할 때 NAS가 가져오는 물리적 주소(IP 주소)에 관계없이 노트북이 동일한 디바이스임을 인식할 수 있어야 합니다. 이렇게 하려면 디바이스에 가져온 IP 주소와 독립적인 ID가 있어야 합니다. 일반적인 로밍 시나리오에서는 DNS와 같은 기존 메커니즘을 사용할 수 없으므로 WS-Addressing 및 WS-Discovery 임시 대안으로 논리적 주소 지정 및 해결 방법을 제공합니다.

디바이스가 제조되면 UUID URI로 표시되는 전역적으로 고유한 식별자가 제공됩니다. 이 식별자는 디바이스에 대해 변경되지 않습니다. 디바이스 전원이 켜지면 항상 WS-Discovery Hello 메시지를 통해 논리 주소를 알리고 WS-Discovery 확인 또는 프로브 메시지를 통해 물리적 주소(일반적으로 HTTP)로 변환하는 요청을 수락합니다. 유효한 실제 주소(IP 주소)를 가져오면 해당 주소를 통해 모든 메시징이 수행되고, 주소가 변경되거나, 디바이스 상태가 변경되고, 클라이언트에 알림을 받거나, 디바이스가 오프라인 상태가 되는 경우에만 WS-Discovery 사용됩니다.

애플리케이션 빌드

WSDAPI는 클라이언트 및 서비스 애플리케이션에서 사용할 수 있는 일반 DPWS SOAP 스택을 제공합니다. 디바이스의 웹 서비스 코드 생성기(WsdCodeGen.exe)를 사용하여 WSDL(서비스 설명)을 애플리케이션이 직접 호출할 수 있는 프록시 및 스텁 코드로 변환할 수 있습니다. 이 생성된 코드는 함수 호출 및 매개 변수를 SOAP 메시지 및 XML 필드로 자동으로 변환한 다음 WSDAPI를 호출하여 원격 디바이스 또는 클라이언트에 대한 요청을 실행합니다.

함수 검색은 WSDAPI 애플리케이션을 빌드할 때 PnP에서 반환된 함수 인스턴스를 만들고 활성화하는 데 사용할 수 있습니다. 이러한 함수 인스턴스에는 단순한 검색 이상의 작업이 필요한 경우 PnP API를 통해 더 많은 정보를 가져오는 데 사용할 수 있는 데이터가 포함되어 있습니다. 자세한 내용은 함수 검색 및 PnP-X를 참조하세요.

관련 항목

검색 및 메타데이터 교환 메시지 패턴

WSDAPI 사양 준수

WSDAPI 인터페이스 개요