6.14.1 Query Information Requests

Query information-type requests differ from set information-type requests in that one or more members in the request structure, denoted by the OUT prefix in the structure definition, are reserved for information to be passed back to the calling process. Members prefixed with IN should be considered read-only. The first member in all query information requests, ulRequestID, is reserved for future use, and should be ignored.

Definitions for the following structures are found in ndistapi.h.

OID_TAPI_DEV_SPECIFIC

This request is used as a general extension mechanism to enable WAN NIC drivers to provide access to features not described in other requests. The meaning of the extensions are device-specific, and taking advantage of these extensions requires the application to be fully aware of them. This function uses an NDIS_TAPI_DEV_SPECIFIC structure.

OID_TAPI_GET_ADDRESS_CAPS

This request queries the specified address on the specfied line device to determine its telephony capabilities. This request uses an NDIS_TAPI_GET_ADDRESS_CAPS structure.

OID_TAPI_GET_ADDRESS_ID

This request returns the address ID associated with the address in a different format on the specified line. This request uses an NDIS_TAPI_GET_ADDRESS_ID structure.

OID_TAPI_GET_ADDRESS_STATUS

This request queries the specified address for its current status and uses an NDIS_TAPI_GET_ADDRESS_STATUS structure.

OID_TAPI_GET_CALL_ADDRESS_ID

This request retrieves the address ID for the indicated call using an NDIS_TAPI_GET_CALL_ADDRESS_ID structure.

OID_TAPI_GET_CALL_INFO

This request returns detailed information about the specified call using an NDIS_TAPI_GET_CALL_INFO structure.

OID_TAPI_GET_CALL_STATUS

This request returns the current status of the specified call using an NDIS_GET_CALL_STATUS structure.

OID_TAPI_GET_DEV_CAPS

This request queries a specified line device to determine its telephony capabilities. The returned information is valid for all addresses on the line device. The request uses an NDIS_TAPI_GET_DEV_CAPS structure.

OID_TAPI_GET_DEV_CONFIG

This request returns a data structure object, the contents of which are specific to the line (WAN miniport NIC driver) and device class, giving the current configuration of a device associated one-to-one with the line device. This request uses an NDIS_TAPI_GET_DEV_CONFIG structure.

OID_TAPI_GET_EXTENSION_ID

This request returns the extension ID that the WAN miniport NIC driver supports for the indicated line device. The request uses an NDIS_TAPI_GET_EXTENSION_ID structure.

OID_TAPI_GET_ID

This request returns a device ID for the specified device class associated with the selected line, address, or call. The request uses an NDIS_TAPI_GET_ID structure.

OID_TAPI_GET_LINE_DEV_STATUS

This request queries the specified open line device for its current status. The information returned is global to all addresses on the line. The request uses an NDIS_TAPI_GET_LINE_DEV_STATUS structure.

OID_TAPI_MAKE_CALL

This request places a call on the specified line to the specified destination address. Optionally, call parameters can be specified if anything but default call-setup parameters are requested. The request uses an NDIS_TAPI_MAKE_CALL structure.

OID_TAPI_NEGOTIATE_EXT_VERSION

This request returns the highest version extension number the miniport is willing to operate under for this device, given the range of possible extension versions. The request uses an NDIS_TAPI_NEGOTIATE_EXT_VERSION structure.

OID_TAPI_OPEN

This request opens the line device whose device ID is given, returning the NIC driver’s handle for the device. The NIC driver must retain the NDISTAPI driver’s handle for the device for use in subsequent calls to the LINE_EVENT callback procedure. The request uses an NDIS_TAPI_OPEN structure.

OID_TAPI_PROVIDER_INITIALIZE

This request initializes the WAN miniport NIC driver to handle TAPI operations. The request uses an NDIS_TAPI_PROVIDER_INIT structure.