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.
Panoramica della tecnologia delle API UPnP.
Per sviluppare API UPnP, sono necessarie queste intestazioni:
Per indicazioni sulla programmazione per questa tecnologia, vedere:
Funzioni
|
Interrompere Il metodo Abort arresta un'operazione di caricamento asincrona avviata da IUPnPDescriptionDocument::LoadAsync. |
|
AddCallback Il metodo AddCallback registra il callback di un'applicazione con il framework UPnP. |
|
AddRequestHeaders Aggiunge l'intestazione HTTP fornita a una richiesta HTTP. |
|
Consigliare Il metodo Advise viene richiamato dall'host del dispositivo per iniziare a ricevere eventi dal servizio ospitato. |
|
AsyncOperationComplete Il metodo di callback AsyncOperationComplete fornisce una notifica del completamento di un'operazione di I/O asincrona. |
|
BeginInvokeAction Il metodo BeginInvokeAction richiama un'azione in un dispositivo in modalità asincrona. Inoltre, se un download scPD ritardato e una sottoscrizione di eventi è consenso esplicito e non è già stato eseguito, questo metodo avvierà il download SCPD. |
|
BeginQueryStateVariable Il metodo BeginQueryStateVariable avvia una richiesta asincrona per il valore della variabile di stato da un servizio specifico. |
|
BeginSCPDDownload Il metodo BeginSCPDDownload avvia il download asincrono di un documento SCPD (Service Control Protocol Description). |
|
BeginSubscribeToEvents BeginSubscribeToEvents avvia la sottoscrizione di eventi in modalità asincrona e registra il callback dell'applicazione con il framework UPnP. |
|
CancelAsyncFind Il metodo CancelAsyncFind annulla una ricerca asincrona. |
|
CancelAsyncOperation Il metodo CancelAsyncOperation annulla un'operazione asincrona in sospeso avviata dai metodi BeginInvokeAction, BeginQueryStateVariable, BeginSubscribeToEvents o BeginSCPDDownload. |
|
CreateAsyncFind Il metodo CreateAsyncFind crea un'operazione di ricerca asincrona. |
|
DeviceAdded Il metodo DeviceAdded viene richiamato dal framework UPnP per notificare all'applicazione che un dispositivo è stato aggiunto alla rete. |
|
DeviceAddedWithInterface Il metodo DeviceAddedWithInterface viene richiamato dal framework UPnP per notificare all'applicazione che un dispositivo è stato aggiunto alla rete. |
|
DeviceByUDN Il metodo DeviceByUDN restituisce il dispositivo con il nome del dispositivo univoco (UDN) specificato contenuto nel documento di descrizione caricato. |
|
DeviceRemoved Il metodo DeviceRemoved viene richiamato dal framework UPnP per notificare all'applicazione che un dispositivo è stato rimosso dalla rete. |
|
EndInvokeAction Il metodo EndInvokeAction recupera i risultati di un'operazione BeginInvokeAction precedente e recupera gli argomenti di output risultanti. |
|
EndQueryStateVariable Il metodo EndQueryStateVariable recupera i risultati di un'operazione BeginQueryStateVariable precedente e recupera il valore della variabile di stato specifica del servizio risultante. |
|
EndSCPDDownload Il metodo EndSCPDDownload recupera i risultati di un download asincrono precedente di un documento SCPD (Service Control Protocol Description). |
|
EndSubscribeToEvents Il metodo EndSubscribeToEvents recupera i risultati di un'operazione BeginSubscribeToEvents precedente. |
|
FindByType Il metodo FindByType cerca in modo sincrono i dispositivi in base al tipo di dispositivo o al tipo di servizio. |
|
FindByUDN Il metodo FindByUDN cerca in modo sincrono un dispositivo in base al nome univoco del dispositivo (UDN). |
|
get__NewEnum La proprietà _NewEnum specifica l'interfaccia dell'enumeratore IEnumVARIANT o IEnumUnknown per la raccolta. (IUPnPDevices.get__NewEnum) |
|
get__NewEnum La proprietà _NewEnum specifica l'interfaccia dell'enumeratore IEnumVARIANT o IEnumUnknown per la raccolta. (IUPnPServices.get__NewEnum) |
|
get_Children La proprietà Children specifica tutti i dispositivi figlio del dispositivo. I dispositivi vengono archiviati in una raccolta IUPnPDevices. |
|
get_Count La proprietà Count specifica il numero di dispositivi nell'insieme. |
|
get_Count La proprietà Count specifica il numero di servizi nell'insieme. |
|
get_Description La proprietà Description specifica un riepilogo leggibile della funzionalità del dispositivo. |
|
get_FriendlyName La proprietà FriendlyName specifica il nome visualizzato del dispositivo. |
|
get_HasChildren La proprietà HasChildren specifica se il dispositivo dispone di dispositivi figlio. |
|
get_Id La proprietà Id specifica l'ID servizio per il servizio. |
|
get_IsRootDevice La proprietà IsRootDevice specifica se il dispositivo è il dispositivo più in alto nell'albero dei dispositivi. |
|
get_Item La proprietà Item specifica l'interfaccia IUPnPDevice per un dispositivo, identificato dall'UDN, nella raccolta. |
|
get_Item La proprietà Item specifica l'interfaccia IUPnPService per un servizio, identificato dall'ID del servizio, nella raccolta. |
|
get_LastTransportStatus Per le query correlate alle variabili evento, la proprietà LastTransportStatus specifica lo stato HTTP dell'ultima operazione IUPnPService::InvokeAction. |
|
get_LoadResult La proprietà LoadResult specifica il codice di esito positivo o negativo di un'operazione di caricamento completata. |
|
get_ManufacturerName La proprietà ManufacturerName specifica una forma leggibile del nome del produttore del dispositivo. |
|
get_ManufacturerURL La proprietà ManufacturerURL specifica l'URL del sito Web del produttore. |
|
get_ModelName La proprietà ModelName specifica una forma leggibile del nome del modello del dispositivo. |
|
get_ModelNumber La proprietà ModelNumber specifica una forma leggibile del numero di modello del dispositivo. |
|
get_ModelURL La proprietà ModelURL specifica l'URL di una pagina Web che contiene informazioni specifiche del modello per il dispositivo. |
|
get_ParentDevice La proprietà ParentDevice specifica l'elemento padre del dispositivo. |
|
get_PresentationURL La proprietà PresentationURL specifica l'URL della presentazione per una pagina Web che controlla il dispositivo. |
|
get_ReadyState La proprietà ReadyState specifica lo stato dell'operazione di caricamento del documento. |
|
get_RootDevice La proprietà RootDevice specifica il dispositivo più in alto nell'albero dei dispositivi. Il dispositivo radice rappresenta un oggetto fisico. |
|
get_SerialNumber La proprietà SerialNumber specifica una forma leggibile del numero di serie del dispositivo. |
|
get_Services La proprietà Services specifica l'elenco dei servizi forniti dal dispositivo. |
|
get_ServiceTypeIdentifier La proprietà ServiceTypeIdentifier specifica l'identificatore del tipo di servizio per il dispositivo. |
|
get_Type Il metodo Type specifica l'URI (Uniform Resource Identifier) del tipo di dispositivo per il dispositivo. |
|
get_UniqueDeviceName La proprietà UniqueDeviceName specifica il nome del dispositivo univoco (UDN) del dispositivo. Un nome definito dall'utente è univoco; nessun dispositivo può avere lo stesso UDN. |
|
get_UPC La proprietà UPC specifica una forma leggibile del codice prodotto. |
|
GetAddressFamily Il metodo GetAddressFamily recupera il valore corrente del flag della famiglia di indirizzi dell'oggetto Device Finder. |
|
GetDocument Recupera il documento di descrizione del dispositivo XML per un dispositivo UPnP. |
|
GetDocument Il metodo GetDocument recupera il documento Service Control Protocol Description (SCPD) per un oggetto servizio. |
|
GetDocumentURL Il metodo GetDocumentURL restituisce l'URL da cui è possibile caricare il documento di descrizione del dispositivo. |
|
GetDocumentURL Il metodo GetDocumentURL recupera l'URL di Service Control Protocol Description (SCPD) per un oggetto servizio. Usando questo URL, il punto di controllo UPnP può scaricare il documento SCPD completo. |
|
GetDwordValue Il metodo GetDwordValue ottiene un valore a 4 byte che fornisce informazioni su una richiesta o un richiedente. |
|
GetGuidValue Il metodo GetGuidValue non è attualmente supportato. |
|
GetServiceObject Il metodo GetServiceObject viene usato per ottenere il puntatore IDispatch a un oggetto servizio specifico. L'host del dispositivo richiama questo metodo una volta per servizio, la prima volta che riceve una richiesta per un servizio. |
|
GetStringValue Il metodo GetStringValue ottiene una stringa che fornisce informazioni su una richiesta o un richiedente. |
|
GetUniqueDeviceName Il metodo GetUniqueDeviceName recupera l'UDN per il dispositivo specificato. |
|
IconURL Il metodo IconURL restituisce un URL da cui è possibile caricare un'icona del formato specificato. |
|
Initialize Il metodo Initialize viene utilizzato per inizializzare il dispositivo. L'host del dispositivo richiama questo metodo. |
|
Invokeaction Richiama un metodo nel dispositivo. |
|
Load Il metodo Load carica un documento in modo sincrono. Questo metodo non restituisce il controllo al chiamante fino al completamento dell'operazione di caricamento. |
|
Loadasync Il metodo LoadAsync carica un documento in modo asincrono. Questo metodo restituisce immediatamente il controllo al chiamante e usa il callback specificato per notificare al chiamante al termine dell'operazione. |
|
LoadComplete Il metodo LoadComplete viene richiamato quando il framework UPnP ha completato il caricamento di una descrizione del dispositivo. |
|
OnStateChanged Il metodo OnStateChanged invia un evento all'host del dispositivo con l'elenco di DISPID delle variabili di stato modificate. L'host del dispositivo deve eseguire una query sull'oggetto servizio per ottenere il nuovo valore per ogni variabile di stato modificata. |
|
OnStateChangedSafe Il metodo OnStateChangedSafe invia un evento all'host del dispositivo con l'elenco di DISPID modificati. L'host del dispositivo deve eseguire una query sull'oggetto servizio per ottenere il nuovo valore per ogni variabile di stato modificata. |
|
QueryStateVariable Il metodo QueryStateVariable restituisce il valore della variabile di stato del servizio specificata. |
|
RegisterDevice Il metodo RegisterDevice registra un dispositivo con l'host del dispositivo. Le informazioni sul dispositivo vengono archiviate dall'host del dispositivo. L'host del dispositivo restituisce quindi un identificatore del dispositivo e pubblica e annuncia il dispositivo nella rete. |
|
RegisterDeviceProvider Il metodo RegisterDeviceProvider registra un provider di dispositivi con l'host del dispositivo. Il provider di dispositivi non viene pubblicato nella rete. Crea invece i dispositivi in modo dinamico e li registra usando RegisterRunningDevice. |
|
RegisterRunningDevice Il metodo RegisterRunningDevice registra un dispositivo in esecuzione con l'host del dispositivo. |
|
RiregisterDevice Il metodo ReregisterDevice registra nuovamente un dispositivo con l'host del dispositivo. Le informazioni sul dispositivo vengono archiviate dall'host del dispositivo. L'host del dispositivo restituisce quindi un identificatore del dispositivo e pubblica e annuncia il dispositivo nella rete. |
|
ReregisterRunningDevice Il metodo ReregisterRunningDevice registra nuovamente un dispositivo in esecuzione con l'host del dispositivo. |
|
RootDevice Il metodo RootDevice restituisce il dispositivo radice dell'albero dei dispositivi del documento attualmente caricato. |
|
SearchComplete Il metodo SearchComplete viene richiamato dal framework UPnP per notificare all'applicazione che la ricerca iniziale dei dispositivi di rete è stata completata. |
|
ServiceInstanceDied Il metodo ServiceInstanceDied viene richiamato quando un servizio non invia più eventi. |
|
SetAddressFamily Il metodo SetAddressFamily imposta il flag della famiglia di indirizzi dell'oggetto Device Finder, che usa questo flag per filtrare i dispositivi trovati. |
|
SetServiceEnumProperty Il metodo SetServiceEnumProperty viene utilizzato per indicare il consenso esplicito per il download ritardato di Service Control Protocol Description (SCPD) e la sottoscrizione di eventi per gli oggetti IUPnPService enumerati dall'oggetto IUPnPServices. |
|
Inizia Il metodo Start avvia il provider di dispositivi. L'host del dispositivo richiama questo metodo dopo il caricamento del provider di dispositivi Questo metodo esegue qualsiasi inizializzazione richiesta dal provider di dispositivi. |
|
StartAsyncFind Il metodo StartAsyncFind avvia un'operazione di ricerca asincrona. |
|
StateVariableChanged Il metodo StateVariableChanged viene richiamato quando viene modificata una variabile di stato. |
|
Stop Il metodo Stop arresta il provider del dispositivo. |
|
Annullare la supervisione Il metodo Unadvise viene richiamato dall'host del dispositivo per interrompere la ricezione di eventi. L'host del dispositivo passa lo stesso puntatore eseguito quando ha richiamato il metodo IUPnPEventSource::Advise. |
|
Annulla registrazioneDispositivo Il metodo UnregisterDevice annulla la registrazione del dispositivo dall'host del dispositivo. Un dispositivo è temporaneamente o definitivamente non registrato. |
|
UnregisterDeviceProvider Il metodo UnregisterDeviceProvider annulla definitivamente la registrazione e scarica il provider di dispositivi dall'host del dispositivo. Viene richiamato il metodo IUPnPDeviceProvider::Stop. |
Interfacce
|
IUPnPAddressFamilyControl L'interfaccia IUPnPAddressFamilyControl accede al flag della famiglia di indirizzi dell'oggetto Device Finder. |
|
IUPnPAsyncResult L'interfaccia IUPnPAsyncResult viene usata per notificare al punto di controllo UPnP un'operazione di I/O asincrona completata. |
|
IUPnPDescriptionDocument L'interfaccia IUPnPDescriptionDocument consente a un'applicazione di caricare una descrizione del dispositivo. |
|
IUPnPDescriptionDocumentCallback L'interfaccia IUPnPDescriptionDocumentCallback consente al framework UPnP di comunicare i risultati di un'operazione di caricamento asincrona a un'applicazione. |
|
IUPnPDevice L'interfaccia IUPnPDevice consente a un'applicazione di recuperare informazioni su un dispositivo specifico. |
|
IUPnPDeviceControl L'interfaccia IUPnPDeviceControl è il punto di gestione centrale per un dispositivo e i relativi oggetti servizio. |
|
IUPnPDeviceDocumentAccess L'interfaccia IUPnPDeviceDocumentAccess consente a un'applicazione di ottenere l'URL del documento di descrizione del dispositivo. |
|
IUPnPDeviceDocumentAccessEx Fornisce un metodo per ottenere l'intero documento di descrizione del dispositivo XML per un dispositivo specifico. |
|
IUPnPDeviceFinder L'interfaccia IUPnPDeviceFinder consente a un'applicazione di trovare un dispositivo. |
|
IUPnPDeviceFinderAddCallbackWithInterface L'interfaccia IUPnPDeviceFinderAddCallbackWithInterface consente al framework UPnP di comunicare con un'applicazione |
|
IUPnPDeviceFinderCallback L'interfaccia IUPnPDeviceFinderCallback consente al framework UPnP di comunicare i risultati di una ricerca asincrona a un'applicazione. |
|
IUPnPDeviceProvider L'interfaccia IUPnPDeviceProvider consente a un provider di dispositivi di avviare e arrestarne l'elaborazione. |
|
IUPnPDevices L'interfaccia IUPnPDevices enumera una raccolta di dispositivi. |
|
IUPnPEventSink L'interfaccia IUPnPEventSink consente a un servizio ospitato di inviare notifiche degli eventi all'host del dispositivo. |
|
IUPnPEventSource L'interfaccia IUPnPEventSource consente all'host del dispositivo di gestire le sottoscrizioni di eventi per il servizio ospitato. |
|
IUPnPHttpHeaderControl Consente al chiamante di specificare intestazioni HTTP aggiuntive inviate nelle richieste HTTP a un dispositivo. |
|
IUPnPRegistrar L'interfaccia IUPnPRegistrar registra i dispositivi eseguiti nel contesto dell'host del dispositivo. |
|
IUPnPRemoteEndpointInfo L'interfaccia IUPnPRemoteEndpointInfo consente a un dispositivo ospitato di ottenere informazioni su un richiedente (ovvero un punto di controllo) e sulla richiesta. |
|
IUPnPReregistrar L'interfaccia IUPnPReregistrar consente all'applicazione di registrare nuovamente un dispositivo basato su UPnP con l'host del dispositivo. |
|
IUPnPService L'interfaccia IUPnPService consente a un'applicazione di eseguire query sulle variabili di stato e richiamare azioni su un'istanza di un servizio. |
|
IUPnPServiceAsync Usare questa interfaccia per eseguire query asincrone sulle variabili di stato e richiamare azioni su un'istanza di un servizio . |
|
IUPnPServiceCallback L'interfaccia IUPnPServiceCallback viene usata per inviare notifiche degli eventi ai client degli oggetti Service. |
|
IUPnPServiceDocumentAccess Usare questa interfaccia per recuperare e fornire il documento SCPD (Service Control Protocol Description) a un'applicazione del punto di controllo UPnP per esporre le azioni supportate dal servizio e fornire informazioni sulle variabili di stato. |
|
IUPnPServiceEnumProperty Usare questa interfaccia per ritardare il download e la sottoscrizione di eventi di Service Control Protocol Description (SCPD) negli oggetti IUPnPService enumerati dall'oggetto IUPnPServices. |
|
IUPnPServices L'interfaccia IUPnPServices enumera una raccolta di servizi. |