Operation
TDI_SET_INFORMATION is a request message a client issues to indicate a set information request.
Note TdiBuildSetInformation is the macro a client uses to fill in the IRP.
A set information request asks the driver to set certain information, such as connection status information and driver statistics. The client can set information about an address, a connection, or a control channel. Along with the request message, the TDI client must provide input and output buffers for the IRP, as well as a status block structure the driver uses to write information about the request. These items are described below. For more information about the members of the IRP related to a set information request, see TdiBuildSetInformation.
For a set information request, the client also needs to provide a set type and optional information needed for the information set. Typically, the output buffer consists of predefined structures that depend on the set type. If the client sets the most significant bit of the set type, the information set is unique to the vendor. Otherwise, TDI defines the set type as one of the following:
| Set Type | Meaning |
| TDI_QUERY_ADDRESS_INFO | Sets an address object for information. The related structure is TDI_ADDRESS_INFO. |
| TDI_QUERY_CONNECTION_INFO | Sets a connection endpoint object for information. The related structure is TDI_CONNECTION_INFO. |
| TDI_QUERY_PROVIDER_INFO | Sets a control channel object for TDI driver information. The related structure is TDI_PROVIDER_INFO. |
| TDI_QUERY_PROVIDER_STATISTICS | Sets a control channel object for TDI driver statistics. The related structure is TDI_PROVIDER_STATISTICS. |
Input
None
Output
None
I/O Status Block
The driver fills in the Status member of the IRP with one of the following status codes:
STATUS_INSUFFICIENT_RESOURCES
STATUS_INVALID_CONNECTION
STATUS_INVALID_DEVICE_REQUEST
STATUS_NOT_IMPLEMENTED
STATUS_SUCCESS
For more information about status codes, see Part II, Chapter 10.
The Information member of the IRP contains the number of data bytes the internal driver set information function uses.
See Also
TDI_ADDRESS_INFO, TDI_CONNECTION_INFO, TDI_PROVIDER_INFO, TDI_PROVIDER_STATISTICS, TdiBuildSetInformation