Feature

Overview

Related Modules:

Samgr

Description:

Defines the base class of a feature.

You need to implement the pointer to the feature.

Since:

1.0

Version:

1.0

Summary

Data Fields

Variable Name

Description

GetName )(Feature feature)

const char ( 

Obtains a feature name.

OnInitialize )(Feature feature, Service parent, Identity identity)

void( 

Initializes a feature.

OnStop )(Feature feature, Identity identity)

void( 

Stops a feature.

OnMessage )(Feature feature, Request request)

BOOL(* 

Processes a feature message.

Details

Field Documentation

GetName

  1. const char*(* Feature::GetName) ([Feature]($api-api-SmartVision-Devices-Feature.md) *feature)

Description:

Obtains a feature name.

This function is implemented by developers and called by Samgr during feature registration and startup.

Parameters:

Name

Description

feature Indicates the pointer to the feature.

Returns:

Returns a constant character string less than 16 bytes if the operation is successful; returns NULL if the operation fails.

OnInitialize

  1. void(* Feature::OnInitialize) ([Feature]($api-api-SmartVision-Devices-Feature.md) *feature, [Service]($api-api-SmartVision-Devices-Service.md) *parent, [Identity]($api-api-SmartVision-Devices-Identity.md) identity)

Description:

Initializes a feature.

This function is implemented by developers. After Samgr dispatches tasks to a service, the service calls this function in its own tasks.

Parameters:

Name

Description

feature Indicates the pointer to the feature.
parent Indicates the pointer to the Service to which the feature belongs.
identity Indicates the identity of a feature dispatched by the system.

OnMessage

  1. BOOL(* Feature::OnMessage) ([Feature]($api-api-SmartVision-Devices-Feature.md) *feature, [Request]($api-api-SmartVision-Devices-Request.md) *request)

Description:

Processes a feature message.

This function is implemented by developers to process requests sent by callers through IUnknown.

Parameters:

Name

Description

feature Indicates the pointer to the feature.
request Indicates the request message.

Returns:

Returns TRUE if the processing is successful; returns FALSE if the processing fails.

OnStop

  1. void(* Feature::OnStop) ([Feature]($api-api-SmartVision-Devices-Feature.md) *feature, [Identity]($api-api-SmartVision-Devices-Identity.md) identity)

Description:

Stops a feature.

This function is implemented by developers and is called by Samgr when a feature is deregistered to stop running services.

Parameters:

Name

Description

feature Indicates the pointer to the feature.
identity Indicates the Identity of the feature to be stopped.