RtndQueryInterfaceFeature

RtndQueryInterfaceFeature gets a given feature of an interface.

Syntax

Copy
BOOL RtndQueryInterfaceFeature(
  [in]    ULONG_PTR RtndInterfaceId,
  [in]    RTND_FEATURE_ID FeatureId,
  [in]    VOID *pFeatureData,
  [in]    ULONG FeatureStructSize
);

Parameters

[in] RtndInterfaceId

The number or pointer used to identify the interface. This value is returned by RtndManageInterface.

[in] FeatureId

The identifier of the feature type to query.

[in] pFeatureData

The address of the feature structure. The exact type depends on the feature type.

[in] FeatureStructSize

The size of the structure pointed to by pFeatureData.

Return Value

If the function succeeds, it returns TRUE. If the function fails, it returns FALSE. To get extended error information, call GetLastError.

Common error codes:

Error code Meaning

ERROR_NOT_SUPPORTED

The requested feature identified by FeatureId is not supported by this driver.

Note: Custom drivers may return other error codes not listed above.

Remarks

The NL2 always calls this function from the main thread of the NL2 process.

To ensure backward and forward compatibility, the NL2 always uses sizeof to get the size of its feature structure at compilation time and zeros out the structure before calling this function.

Characteristics

Real-time requirements

Deterministic behavior

Not required

Local memory allocation/deallocation restrictions

Process

External MSpace

Internal MSpace

System

Allowed

Allowed

Process

Allowed

Allowed

Contiguous memory allocation/deallocation restrictions

Contiguous memory

Allowed

Requirements

Minimum supported version Header

eRTOS 1.0 SDK

Rtnd.h

See Also: