PerceptionFrameProviderManagerService.RegisterControlGroup Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Registers a PerceptionControlGroup associated with the IPerceptionFrameProviderManager.
public:
static void RegisterControlGroup(IPerceptionFrameProviderManager ^ manager, PerceptionControlGroup ^ controlGroup); static void RegisterControlGroup(IPerceptionFrameProviderManager const& manager, PerceptionControlGroup const& controlGroup);/// [Windows.Foundation.Metadata.Deprecated("PerceptionFrameProviderManagerService may be unavailable after Windows Creator Update. Please refer to AVStream on MSDN.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 262144, "Windows.Foundation.UniversalApiContract")]
static void RegisterControlGroup(IPerceptionFrameProviderManager const& manager, PerceptionControlGroup const& controlGroup);public static void RegisterControlGroup(IPerceptionFrameProviderManager manager, PerceptionControlGroup controlGroup);[Windows.Foundation.Metadata.Deprecated("PerceptionFrameProviderManagerService may be unavailable after Windows Creator Update. Please refer to AVStream on MSDN.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 262144, "Windows.Foundation.UniversalApiContract")]
public static void RegisterControlGroup(IPerceptionFrameProviderManager manager, PerceptionControlGroup controlGroup);function registerControlGroup(manager, controlGroup)Public Shared Sub RegisterControlGroup (manager As IPerceptionFrameProviderManager, controlGroup As PerceptionControlGroup)Parameters
- manager
- IPerceptionFrameProviderManager
The manager that owns the lifetime of the group.
- controlGroup
- PerceptionControlGroup
The group of IPerceptionFrameProvider(s) to control atomically.
- Attributes
Remarks
The PerceptionControlGroup's ids used to create it can't appear in a PerceptionControlGroup which is already registered. Doing so raises an InvalidArgumentException.
The PerceptionControlGroup specifies which IPerceptionFrameProvider(s) will be arbitrated for control together when control is successfully requested by an app and revoked when control is revoked from the app.
When a PerceptionControlSession is acquired for a PerceptionControlGroup, that app may set properties on each provider in the group. Before the IPerceptionFrameProvider is registered in a control group, attempts to control it will fail and properties can't be set.