RtndSetInterface

RtndSetInterface writes a given setting to the interface.

Syntax

BOOL RtndSetInterface(
  [in]    ULONG_PTR RtndInterfaceId,
  [in]    ULONG QueueIndex,
  [in]    RTND_SETTING_ID SettingId,
  [in]    const VOID *pSettingData,
  [in]    ULONG SettingStructSize
);

Parameters

[in] RtndInterfaceId

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

[in] QueueIndex

The target index of the Transmit or Receive queue. This parameter is ignored if the operation is at the interface level.

[in] SettingId

The identifier of the setting type.

[in] pSettingData

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

[in] SettingStructSize

The size of the structure pointed to by pSettingData.

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:

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 setting structure at compilation time and zeros out the structure before populating it and calling this function.

Characteristics

Requirements

See Also:

• RTND_SETTING_ID
• RtndManageInterface
• RtndStopInterface