WWAN_PCO_VALUE structure (wwan.h)
The WWAN_PCO_VALUE structure represents the PCO information payload from the network as defined in the 3GPP TS24.008 spec.
Syntax
typedef struct _WWAN_PCO_VALUE {
ULONG Size;
WWAN_PCO_TYPE Type;
BYTE PcoData[WWAN_PCO_OCT_BUF_LEN];
} WWAN_PCO_VALUE, *PWWAN_PCO_VALUE;
Members
Size
The length of the PCO value that is valid in PcoData, which will be octets 3 (octet 1 to 3) + (m * protocol element length) + (n * container element length). This is defined in the 3GPP TS24.008 spec, Section 10.5 because PCO is Type 4 information.
Type
Indicates whether the PCO value being passed up is the original structure that was received by the modem or a subset of the full PCO structure and has the header synthesized. For more info, see WWAN_PCO_TYPE.
PcoData[WWAN_PCO_OCT_BUF_LEN]
The payload of the PCO structure that is received from the operator. The modem should surface the PCO with the complete structure as specified by the 3G TS24.008 spec. WWAN_PCO_OCT_BUF_LEN is defined as 256, given that the longest a PCO structure could be is 253 octets.
Remarks
Because some modems can currently only pass up operator specific PCO elements, the modem should pass up the information following the structure defined by 3GPP TS24.008 with the accurate synthesized header values for the content that is being passed up to the host.
For example, if the modem received a PCO with 3 protocols and 3 containers, and is only passing up the 2 operator specific element containers to the host, the modem will make changes to the header that indicates the length of the PCO structure. This is to reflect the fact that there are only the two containers by subtracting the length of the 3 protocols.
The following figure shows a full PCO structure as defined in the 3G TS24.008 spec.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows 10, version 1709 |
Header | wwan.h (include Wwan.h) |