2.2.4.1.7.2 GetDeviceFlags

The GetDeviceFlags packet retrieves the zero-based device ID and device capabilities flag for the specified device. This request is only supported for line devices. The returned flags match those that are returned by the service in dwDevCapsFlags of the LINEDEVCAPS packet.


0


1


2


3


4


5


6


7


8


9

1
0


1


2


3


4


5


6


7


8


9

2
0


1


2


3


4


5


6


7


8


9

3
0


1

Req_Func

Reserved1

hLineApp

fLine

dwProviderID

dwPermanentDeviceID

dwFlags

dwDeviceID

Reserved2

Reserved3

Reserved4

Reserved5

Reserved6

Reserved7

Reserved8

Req_Func (4 bytes): The identifier of the function that will be invoked on the remote server. This value MUST be set to 165.

On completion of ClientRequest, this field MUST contain the result of the encapsulated telephony request. A value of 0 indicates success, and a LINEERR_Constants value indicates failure. The remote server MUST complete this call synchronously.

Reserved1 (4 bytes): An unsigned 32-bit integer. MUST be set to zero when sent and MUST be ignored on receipt.

hLineApp (4 bytes): An HLINEAPP. The handle to the application registration with TAPI. This field MUST have been obtained by sending the Initialize packet.

fLine (4 bytes): An unsigned 32-bit integer. The value equals 1 for line devices and 0 for phone devices.

dwProviderID (4 bytes): An unsigned 32-bit integer. The provider identifier of the entry.

dwPermanentDeviceID (4 bytes): An unsigned 32-bit integer. Unsupported; set to zero.

dwFlags (4 bytes): An unsigned 32-bit integer. Upon successful completion of the request, this field MUST contain the device capabilities. This member MUST use one or more of the LINEDEVCAPFLAGS_Constants.

dwDeviceID (4 bytes): An unsigned 32-bit integer. Upon successful completion of the request, this field MUST contain the value of the device ID, which can be greater than or equal to 0.

Reserved2 (4 bytes): An unsigned 32-bit integer. MUST be set to zero when sent and MUST be ignored on receipt.

Reserved3 (4 bytes): An unsigned 32-bit integer. MUST be set to zero when sent and MUST be ignored on receipt.

Reserved4 (4 bytes): An unsigned 32-bit integer. MUST be set to zero when sent and MUST be ignored on receipt.

Reserved5 (4 bytes): An unsigned 32-bit integer. MUST be set to zero when sent and MUST be ignored on receipt.

Reserved6 (4 bytes): An unsigned 32-bit integer. MUST be set to zero when sent and MUST be ignored on receipt.

Reserved7 (4 bytes): An unsigned 32-bit integer. MUST be set to zero when sent and MUST be ignored on receipt.

Reserved8 (4 bytes): An unsigned 32-bit integer. MUST be set to zero when sent and MUST be ignored on receipt.