IActiveBasicDevice interface (windows.media.streaming.h)
[The feature associated with this page, Windows Media Streaming API, is a legacy feature. It has been superseded by Media Casting. Media Casting has been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use Media Casting instead of Windows Media Streaming API, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]
Represents an active IBasicDevice that is associated with a UPnP device.
Inheritance
The IActiveBasicDevice interface inherits from IBasicDevice. IActiveBasicDevice also has these types of members:
Methods
The IActiveBasicDevice interface has these methods.
| IActiveBasicDevice::GetCachedBitrateMeasurement Gets the cached bitrate. |
| IActiveBasicDevice::GetCachedExtraSinkProtocolInfo Gets additional cached sink protocol info for the device. |
| IActiveBasicDevice::GetCachedSinkProtocolInfo Gets the cached sink protocol info for the device. |
| IActiveBasicDevice::GetEffectiveBandwidth Gets the current effective bandwidth for the device. |
| IActiveBasicDevice::NotifyStreamingStatus Called by the application to indicate that the device is being used for active streaming. |
| IActiveBasicDevice::SetCachedBitrateMeasurement Sets the cached bitrate. |
| IActiveBasicDevice::SetCachedSinkProtocolInfo Gets the cached sink protocol info for the device. |
Remarks
An IActiveBasicDevice is associated with a UPnP device. To retrieve a pointer to the underlying IUPnPDevice, IServiceProvider->QueryService can be used with GUID_NativeDeviceService to get native interfaces for the device.
For example, you can retrieve a IUPnPDevice pointer as follows:
pActiveBasicDevice->QueryService( GUID_NativeDeviceService, IID_IUPnPDevice, (void **)&spUPnPDevice );
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 8.1 [desktop apps only] |
| Minimum supported server | Windows Server 2012 R2 [desktop apps only] |
| Target Platform | Windows |
| Header | windows.media.streaming.h |