TSPI_lineSetLineDevStatus function (tspi.h)

The TSPI_lineSetLineDevStatus service provider sets the device status as indicated, sending appropriate LINE_LINEDEVSTATE messages to indicate the new status.

Syntax

LONG TSPIAPI TSPI_lineSetLineDevStatus(
  DRV_REQUESTID dwRequestID,
  HDRVLINE      hdLine,
  DWORD         dwStatusToChange,
  DWORD         fStatus
);

Parameters

dwRequestID

Identifier for reporting asynchronous function results.

hdLine

The service provider's handle to the line device.

dwStatusToChange

One or more of the LINEDEVSTATUSFLAGS_ constants.

fStatus

TRUE to turn on the indicated status bit(s), FALSE to turn off.

Return value

Returns dwRequestID if the asynchronous operation starts; otherwise, the function returns one of these negative error values:

LINEERR_INVALLINESTATE, LINEERR_INVALPARAM, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_RESOURCEUNAVAIL.

Requirements

See also

LINE_LINEDEVSTATE