UPNPDEVICEINFO (Windows Embedded CE 6.0)

[アーティクル]
01/05/2012

1/6/2010

This structure identifies a UPnP device. It is used by the UpnpAddDevice function.

Syntax

typedef struct {
  DWORD cbStruct;
  PWSTR pszDeviceDescription;
  PWSTR pszDeviceName;
  PWSTR pszUDN;
  DWORD cachecontrol;
  PUPNPCALLBACK pfCallback;
  PVOID pvUserDevContext; 
} UPNPDEVICEINFO;

Members

cbStruct
Sizeof (UPNPDEVICEINFO).

pszDeviceDescription
XML device description template.

pszDeviceName
The local identifier for the device. This may be any string, using only characters that are valid for file names. Most of the functions in the UPnP device API refer to a device instance by this name. If a device by this name is already hosted on this system, an error is returned.

pszUDN
Optional UDN. If specified, this becomes the Universal Device Name (UDN) for this device. Must begin with uuid:. If this parameter is NULL, the UPnP service will generate a suitable UUID. The UPnP architecture recommends that the UDN be unchanged across device reboots. Because the UPnP device API does not persist the UDN, this field allows the application to ensure that it gets the same UDN after the device is removed and re-added.

cachecontrol
Device lifetime in seconds. The device announcements are sent at this interval. If initialized to 0, the default lifetime is assumed.

pfCallback
Pointer to the device callback function. See definition of PUPNPCALLBACK. The device implementation should be prepared to receive callback messages at any time until the UpnpRemoveDevice function is called.

pvUserDevContext
Caller-supplied instance data. Treated as an opaque field by the UPnP service and passed in as the second parameter to the device callback function.

Requirements

Header	upnpdevapi.h
Windows Embedded CE	Windows CE .NET 4.0 and later

See Also

Reference

UPnP C Device Host Structures
UpnpAddDevice
UpnpRemoveDevice