UPnP API
UPnP API 기술 개요입니다.
UPnP API를 개발하려면 다음 헤더가 필요합니다.
이 기술에 대한 프로그래밍 지침은 다음을 참조하세요.
중단 Abort 메서드는 IUPnPDescriptionDocument::LoadAsync에서 시작한 비동기 로드 작업을 중지합니다. |
AddCallback AddCallback 메서드는 애플리케이션의 콜백을 UPnP 프레임워크에 등록합니다. |
AddRequestHeaders 제공된 HTTP 헤더를 HTTP 요청에 추가합니다. |
조언 Advise 메서드는 호스트된 서비스에서 이벤트 수신을 시작하기 위해 디바이스 호스트에서 호출됩니다. |
AsyncOperationComplete AsyncOperationComplete 콜백 메서드는 비동기 I/O 작업의 완료에 대한 알림을 제공합니다. |
BeginInvokeAction BeginInvokeAction 메서드는 비동기 모드에서 디바이스에서 작업을 호출합니다. 또한 지연된 SCPD 다운로드 및 이벤트 구독이 옵트인되고 아직 수행되지 않은 경우 이 메서드는 SCPD 다운로드를 시작합니다. |
BeginQueryStateVariable BeginQueryStateVariable 메서드는 특정 서비스의 상태 변수 값에 대한 비동기 요청을 시작합니다. |
BeginSCPDDownload BeginSCPDDownload 메서드는 SCPD(서비스 제어 프로토콜 설명) 문서의 비동기 다운로드를 시작합니다. |
BeginSubscribeToEvents BeginSubscribeToEvents는 비동기 모드에서 이벤트 구독을 시작하고 UPnP 프레임워크에 애플리케이션 콜백을 등록합니다. |
CancelAsyncFind CancelAsyncFind 메서드는 비동기 검색을 취소합니다. |
CancelAsyncOperation CancelAsyncOperation 메서드는 BeginInvokeAction, BeginQueryStateVariable, BeginSubscribeToEvents 또는 BeginSCPDDownload 메서드에 의해 시작된 보류 중인 비동기 작업을 취소합니다. |
CreateAsyncFind CreateAsyncFind 메서드는 비동기 검색 작업을 만듭니다. |
DeviceAdded DeviceAdded 메서드는 UPnP 프레임워크에서 호출되어 디바이스가 네트워크에 추가되었음을 애플리케이션에 알립니다. |
DeviceAddedWithInterface DeviceAddedWithInterface 메서드는 UPnP 프레임워크에서 호출되어 디바이스가 네트워크에 추가되었음을 애플리케이션에 알립니다. |
DeviceByUDN DeviceByUDN 메서드는 로드된 설명 문서에 포함된 지정된 UDN(고유 디바이스 이름)을 사용하여 디바이스를 반환합니다. |
DeviceRemoved DeviceRemoved 메서드는 UPnP 프레임워크에서 호출되어 네트워크에서 디바이스가 제거되었음을 애플리케이션에 알립니다. |
EndInvokeAction EndInvokeAction 메서드는 이전 BeginInvokeAction 작업의 결과를 검색하고 결과 출력 인수를 검색합니다. |
EndQueryStateVariable EndQueryStateVariable 메서드는 이전 BeginQueryStateVariable 작업의 결과를 검색하고 결과 서비스별 상태 변수 값을 검색합니다. |
EndSCPDDownload EndSCPDDownload 메서드는 SCPD(서비스 제어 프로토콜 설명) 문서의 이전 비동기 다운로드 결과를 검색합니다. |
EndSubscribeToEvents EndSubscribeToEvents 메서드는 이전 BeginSubscribeToEvents 작업의 결과를 검색합니다. |
FindByType FindByType 메서드는 디바이스 유형 또는 서비스 유형별로 디바이스를 동기적으로 검색합니다. |
FindByUDN FindByUDN 메서드는 고유한 UDN(디바이스 이름)으로 디바이스를 동기적으로 검색합니다. |
get__NewEnum _NewEnum 속성은 컬렉션에 대한 IEnumVARIANT 또는 IEnumUnknown 열거자 인터페이스를 지정합니다. (IUPnPDevices.get__NewEnum) |
get__NewEnum _NewEnum 속성은 컬렉션에 대한 IEnumVARIANT 또는 IEnumUnknown 열거자 인터페이스를 지정합니다. (IUPnPServices.get__NewEnum) |
get_Children Children 속성은 디바이스의 모든 자식 디바이스를 지정합니다. 디바이스는 IUPnPDevices 컬렉션에 저장됩니다. |
get_Count Count 속성은 컬렉션의 디바이스 수를 지정합니다. |
get_Count Count 속성은 컬렉션의 서비스 수를 지정합니다. |
get_Description Description 속성은 디바이스 기능에 대한 사람이 읽을 수 있는 요약을 지정합니다. |
get_FriendlyName FriendlyName 속성은 디바이스의 디바이스 표시 이름을 지정합니다. |
get_HasChildren HasChildren 속성은 디바이스에 자식 디바이스가 있는지 여부를 지정합니다. |
get_Id Id 속성은 서비스의 서비스 ID를 지정합니다. |
get_IsRootDevice IsRootDevice 속성은 디바이스가 디바이스 트리에서 가장 상위 디바이스인지 여부를 지정합니다. |
get_Item Item 속성은 컬렉션에서 UDN으로 식별되는 디바이스에 대한 IUPnPDevice 인터페이스를 지정합니다. |
get_Item Item 속성은 컬렉션에서 서비스 ID로 식별되는 서비스에 대한 IUPnPService 인터페이스를 지정합니다. |
get_LastTransportStatus 이벤트 변수와 관련된 쿼리의 경우 LastTransportStatus 속성은 마지막 IUPnPService::InvokeAction 작업의 HTTP 상태 지정합니다. |
get_LoadResult LoadResult 속성은 완료된 로드 작업의 성공 또는 실패 코드를 지정합니다. |
get_ManufacturerName ManufacturerName 속성은 사람이 읽을 수 있는 디바이스의 제조업체 이름 형식을 지정합니다. |
get_ManufacturerURL ManufacturerURL 속성은 제조업체 웹 사이트의 URL을 지정합니다. |
get_ModelName ModelName 속성은 사람이 읽을 수 있는 디바이스의 모델 이름 형식을 지정합니다. |
get_ModelNumber ModelNumber 속성은 사람이 읽을 수 있는 디바이스의 모델 번호 형식을 지정합니다. |
get_ModelURL ModelURL 속성은 디바이스에 대한 모델별 정보를 포함하는 웹 페이지의 URL을 지정합니다. |
get_ParentDevice ParentDevice 속성은 디바이스의 부모를 지정합니다. |
get_PresentationURL PresentationURL 속성은 디바이스를 제어하는 웹 페이지의 프레젠테이션 URL을 지정합니다. |
get_ReadyState ReadyState 속성은 문서 로드 작업의 상태 지정합니다. |
get_RootDevice RootDevice 속성은 디바이스 트리에서 최상위 디바이스를 지정합니다. 루트 디바이스는 물리적 개체를 나타냅니다. |
get_SerialNumber SerialNumber 속성은 사람이 읽을 수 있는 디바이스 일련 번호 형식을 지정합니다. |
get_Services Services 속성은 디바이스에서 제공하는 서비스 목록을 지정합니다. |
get_ServiceTypeIdentifier ServiceTypeIdentifier 속성은 디바이스의 서비스 유형 식별자를 지정합니다. |
get_Type Type 메서드는 디바이스에 대한 디바이스 유형 URI(Uniform Resource Identifier)를 지정합니다. |
get_UniqueDeviceName UniqueDeviceName 속성은 디바이스의 고유한 UDN(디바이스 이름)을 지정합니다. UDN은 고유합니다. 두 디바이스가 동일한 UDN을 가질 수 없습니다. |
get_UPC UPC 속성은 사람이 읽을 수 있는 제품 코드 형식을 지정합니다. |
GetAddressFamily GetAddressFamily 메서드는 Device Finder 개체의 주소 패밀리 플래그의 현재 값을 검색합니다. |
GetDocument UPnP 디바이스에 대한 XML 디바이스 설명 문서를 검색합니다. |
GetDocument GetDocument 메서드는 서비스 개체에 대한 SCPD(서비스 제어 프로토콜 설명) 문서를 검색합니다. |
GetDocumentURL GetDocumentURL 메서드는 디바이스 설명 문서를 로드할 수 있는 URL을 반환합니다. |
GetDocumentURL GetDocumentURL 메서드는 서비스 개체에 대한 SCPD(서비스 제어 프로토콜 설명) URL을 검색합니다. UPnP 제어점은 이 URL을 사용하여 전체 SCPD 문서를 다운로드할 수 있습니다. |
GetDwordValue GetDwordValue 메서드는 요청 또는 요청자에 대한 정보를 제공하는 4 바이트 값을 가져옵니다. |
GetGuidValue GetGuidValue 메서드는 현재 지원되지 않습니다. |
GetServiceObject GetServiceObject 메서드는 특정 서비스 개체에 대한 IDispatch 포인터를 가져오는 데 사용됩니다. 디바이스 호스트는 서비스에 대한 요청을 처음 수신할 때 서비스당 한 번 이 메서드를 호출합니다. |
GetStringValue GetStringValue 메서드는 요청 또는 요청자에 대한 정보를 제공하는 문자열을 가져옵니다. |
GetUniqueDeviceName GetUniqueDeviceName 메서드는 지정된 디바이스에 대한 UDN을 검색합니다. |
IconURL IconURL 메서드는 지정된 형식의 아이콘을 로드할 수 있는 URL을 반환합니다. |
초기화 Initialize 메서드는 디바이스를 초기화하는 데 사용됩니다. 디바이스 호스트는 이 메서드를 호출합니다. |
InvokeAction 디바이스에서 메서드를 호출합니다. |
로드 Load 메서드는 문서를 동기적으로 로드합니다. 이 메서드는 부하 작업이 완료될 때까지 호출자에게 컨트롤을 반환하지 않습니다. |
Loadasync LoadAsync 메서드는 문서를 비동기적으로 로드합니다. 이 메서드는 호출자에게 컨트롤을 즉시 반환하고 지정된 콜백을 사용하여 작업이 완료되면 호출자에게 알립니다. |
LoadComplete LoadComplete 메서드는 UPnP 프레임워크가 디바이스 설명 로드를 완료했을 때 호출됩니다. |
OnStateChanged OnStateChanged 메서드는 변경된 상태 변수의 DISPID 목록이 있는 이벤트를 디바이스 호스트로 보냅니다. 디바이스 호스트는 서비스 개체를 쿼리하여 변경된 각 상태 변수에 대한 새 값을 가져와야 합니다. |
OnStateChangedSafe OnStateChangedSafe 메서드는 변경된 DISPID 목록을 사용하여 이벤트를 디바이스 호스트로 보냅니다. 디바이스 호스트는 서비스 개체를 쿼리하여 변경된 각 상태 변수에 대한 새 값을 가져와야 합니다. |
QueryStateVariable QueryStateVariable 메서드는 지정된 서비스의 상태 변수 값을 반환합니다. |
RegisterDevice RegisterDevice 메서드는 디바이스 호스트에 디바이스를 등록합니다. 디바이스 정보는 디바이스 호스트에 의해 저장됩니다. 그런 다음 디바이스 호스트는 디바이스 식별자를 반환하고 네트워크에서 디바이스를 게시하고 알릴 수 있습니다. |
RegisterDeviceProvider RegisterDeviceProvider 메서드는 디바이스 호스트에 디바이스 공급자를 등록합니다. 디바이스 공급자가 네트워크에 게시되지 않습니다. 대신 디바이스를 동적으로 만들고 RegisterRunningDevice를 사용하여 등록합니다. |
RegisterRunningDevice RegisterRunningDevice 메서드는 실행 중인 디바이스를 디바이스 호스트에 등록합니다. |
ReregisterDevice ReregisterDevice 메서드는 디바이스 호스트에 디바이스를 다시 등록합니다. 디바이스 정보는 디바이스 호스트에 의해 저장됩니다. 그런 다음 디바이스 호스트는 디바이스 식별자를 반환하고 네트워크에서 디바이스를 게시하고 알릴 수 있습니다. |
ReregisterRunningDevice ReregisterRunningDevice 메서드는 실행 중인 디바이스를 디바이스 호스트에 다시 등록합니다. |
RootDevice RootDevice 메서드는 현재 로드된 문서의 디바이스 트리의 루트 디바이스를 반환합니다. |
SearchComplete SearchComplete 메서드는 UPnP 프레임워크에서 호출되어 네트워크 디바이스에 대한 초기 검색이 완료되었음을 애플리케이션에 알립니다. |
ServiceInstanceDied ServiceInstanceDied 메서드는 서비스가 더 이상 이벤트를 보내지 않을 때 호출됩니다. |
SetAddressFamily SetAddressFamily 메서드는 Device Finder 개체의 주소 패밀리 플래그를 설정합니다. 이 플래그는 이 플래그를 사용하여 찾은 디바이스를 필터링합니다. |
SetServiceEnumProperty SetServiceEnumProperty 메서드는 IUPnPServices 개체에서 열거된 IUPnPService 개체에 대해 지연된 SCPD(서비스 제어 프로토콜 설명) 다운로드 및 이벤트 구독에 대한 옵트인을 나타내는 데 사용됩니다. |
시작 Start 메서드는 디바이스 공급자를 시작합니다. 디바이스 호스트는 디바이스 공급자를 로드한 후 이 메서드를 호출합니다. 이 메서드는 디바이스 공급자에 필요한 모든 초기화를 수행합니다. |
StartAsyncFind StartAsyncFind 메서드는 비동기 검색 작업을 시작합니다. |
StateVariableChanged StateVariableChanged 메서드는 상태 변수가 변경될 때 호출됩니다. |
중지 Stop 메서드는 디바이스 공급자를 중지합니다. |
Unadvise Unadvise 메서드는 이벤트 수신을 중지하기 위해 디바이스 호스트에서 호출됩니다. 디바이스 호스트는 IUPnPEventSource::Advise 메서드를 호출할 때와 동일한 포인터를 전달합니다. |
UnregisterDevice UnregisterDevice 메서드는 디바이스 호스트에서 디바이스의 등록을 취소합니다. 디바이스가 일시적으로 또는 영구적으로 등록 취소되었습니다. |
UnregisterDeviceProvider UnregisterDeviceProvider 메서드는 디바이스 호스트에서 디바이스 공급자의 등록을 영구적으로 취소하고 언로드합니다. IUPnPDeviceProvider::Stop 메서드가 호출됩니다. |
IUPnPAddressFamilyControl IUPnPAddressFamilyControl 인터페이스는 Device Finder 개체의 주소 패밀리 플래그에 액세스합니다. |
IUPnPAsyncResult IUPnPAsyncResult 인터페이스는 완료된 비동기 I/O 작업의 UPnP 제어 지점에 알리는 데 사용됩니다. |
IUPnPDescriptionDocument IUPnPDescriptionDocument 인터페이스를 사용하면 애플리케이션이 디바이스 설명을 로드할 수 있습니다. |
IUPnPDescriptionDocumentCallback IUPnPDescriptionDocumentCallback 인터페이스를 사용하면 UPnP 프레임워크가 비동기 로드 작업의 결과를 애플리케이션에 전달할 수 있습니다. |
IUPnPDevice IUPnPDevice 인터페이스를 사용하면 애플리케이션이 특정 디바이스에 대한 정보를 검색할 수 있습니다. |
IUPnPDeviceControl IUPnPDeviceControl 인터페이스는 디바이스 및 해당 서비스 개체에 대한 관리의 중심 지점입니다. |
IUPnPDeviceDocumentAccess IUPnPDeviceDocumentAccess 인터페이스를 사용하면 애플리케이션이 디바이스 설명 문서의 URL을 가져올 수 있습니다. |
IUPnPDeviceDocumentAccessEx 특정 디바이스에 대한 전체 XML 디바이스 설명 문서를 가져오는 메서드를 제공합니다. |
IUPnPDeviceFinder IUPnPDeviceFinder 인터페이스를 사용하면 애플리케이션에서 디바이스를 찾을 수 있습니다. |
IUPnPDeviceFinderAddCallbackWithInterface IUPnPDeviceFinderAddCallbackWithInterface 인터페이스를 사용하면 UPnP 프레임워크가 애플리케이션과 통신할 수 있습니다. |
IUPnPDeviceFinderCallback IUPnPDeviceFinderCallback 인터페이스를 사용하면 UPnP 프레임워크가 비동기 검색 결과를 애플리케이션에 전달할 수 있습니다. |
IUPnPDeviceProvider IUPnPDeviceProvider 인터페이스를 사용하면 디바이스 공급자가 해당 처리를 시작하고 중지할 수 있습니다. |
IUPnPDevices IUPnPDevices 인터페이스는 디바이스 컬렉션을 열거합니다. |
IUPnPEventSink IUPnPEventSink 인터페이스를 사용하면 호스트된 서비스가 디바이스 호스트에 이벤트 알림을 보낼 수 있습니다. |
IUPnPEventSource IUPnPEventSource 인터페이스를 사용하면 디바이스 호스트가 호스트된 서비스에 대한 이벤트 구독을 관리할 수 있습니다. |
IUPnPHttpHeaderControl 호출자가 디바이스에 대한 HTTP 요청에서 전송된 추가 HTTP 헤더를 지정할 수 있도록 합니다. |
IUPnPRegistrar IUPnPRegistrar 인터페이스는 디바이스 호스트의 컨텍스트에서 실행되는 디바이스를 등록합니다. |
IUPnPRemoteEndpointInfo IUPnPRemoteEndpointInfo 인터페이스를 사용하면 호스트된 디바이스가 요청자(즉, 제어점) 및 요청에 대한 정보를 가져올 수 있습니다. |
IUPnPReregistrar IUPnPReregistrar 인터페이스를 사용하면 애플리케이션이 디바이스 호스트에 UPnP 기반 디바이스를 다시 등록할 수 있습니다. |
IUPnPService IUPnPService 인터페이스를 사용하면 애플리케이션이 상태 변수를 쿼리하고 서비스의 instance 작업을 호출할 수 있습니다. |
IUPnPServiceAsync 이 인터페이스를 사용하여 상태 변수를 비동기적으로 쿼리하고 서비스의 instance 작업을 호출합니다. |
IUPnPServiceCallback IUPnPServiceCallback 인터페이스는 서비스 개체의 클라이언트에 이벤트 알림을 보내는 데 사용됩니다. |
IUPnPServiceDocumentAccess 이 인터페이스를 사용하여 SCPD(서비스 제어 프로토콜 설명) 문서를 검색하여 UPnP 제어 지점 애플리케이션에 제공하여 서비스에서 지원하는 작업을 노출하고 상태 변수에 대한 정보를 제공합니다. |
IUPnPServiceEnumProperty 이 인터페이스를 사용하여 IUPnPServices 개체에서 열거된 IUPnPService 개체에서 SCPD(서비스 제어 프로토콜 설명) 다운로드 및 이벤트 구독을 지연할 수 있습니다. |
IUPnPServices IUPnPServices 인터페이스는 서비스 컬렉션을 열거합니다. |