OID_TAPI_SET_DEV_CONFIG

The OID_TAPI_SET_DEV_CONFIG OID requests the miniport driver to restore the configuration of a device associated one-to-one with the line device from a configuration previously obtained using OID_TAPI_GET_DEV_CONFIG.

The contents of this structure are specific to the miniport driver's line and device class.

Support for this request is mandatory.

This request uses an NDIS_TAPI_SET_DEV_CONFIG structure, defined as follows:

typedef struct _NDIS_TAPI_SET_DEV_CONFIG {         
         IN ULONG ulRequestID;
         IN ULONG ulDeviceID;
         IN ULONG ulDeviceClassSize;
         IN ULONG ulDeviceClassOffset;
         IN ULONG ulDeviceConfigSize;
         IN UCHAR DeviceConfig[1];
 } NDIS_TAPI_SET_DEV_CONFIG, *PNDIS_TAPI_SET_DEV_CONFIG;

The members of this structure contain the following information:

  • ulRequestID
    Reserved.

  • ulDeviceID
    Specifies the line device to be configured. This value was set up in a preceding OID_TAPI_PROVIDER_INITIALIZE request.

  • ulDeviceClassSize
    Specifies the size in bytes of the device class for the device whose configuration is to be restored. Valid device class strings are the same as those specified for the OID_TAPI_GET_ID request when it is applied to a "line" device ( ulSelect has the value LINECALLSELECT_LINE).

  • ulDeviceClassOffset
    Specifies the offset in bytes to the device class of the device whose configuration is to be restored.

  • ulDeviceConfigSize
    Specifies the number of bytes at DeviceConfig. This value was already returned in the ulStringSize member in the VAR_STRING structure returned for a preceding OID_TAPI_GET_DEV_CONFIG request.

  • DeviceConfig
    Specifies data that was returned in the variable portion of the VAR_STRING structure for a preceding OID_TAPI_GET_DEV_CONFIG request.

The MiniportSetInformationfunction can return one of the following:

NDIS_STATUS_SUCCESS

NDIS_STATUS_PENDING

NDIS_STATUS_TAPI_INVALDEVICECLASS

NDIS_STATUS_TAPI_INVALPARAM

NDIS_STATUS_TAPI_NODRIVER

NDIS_STATUS_TAPI_RESOURCEUNAVAIL

NDIS_STATUS_FAILURE

 

 

Send comments about this topic to Microsoft