|This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.|
This function reads and decodes the CISTPL_CONFIG and CISTPL_CFTABLE_ENTRY tuples. These tuples are both complex and difficult to decode; this function stores the information in those tuples in data structures that are easier to access.
STATUS CardGetParsedTuple( CARD_SOCKET_HANDLE hSocket UINT8 uDesiredTuple PVOID pBuf PUINT32 pnItems );
CERR_SUCCESS indicates success. One of the following values indicates failure:
This function reads the CIS data from the specified PC Card of the specified tuple code and formats the encoded data into an easily accessed structure. This function reduces code size by eliminating extra processing required to parse some variable-length tuples, thus duplication of code to process these tuples.
Currently, Windows CE supports only the CISTPL_CONFIG and CISTPL_CFTABLE_ENTRY tuples for parsing.
When this function is called with CISTPL_CONFIG, it retrieves a PARSED_CONFIGstructure. When it is called with CISTPL_CFTABLE_ENTRY, it retrieves a PARSED_CFTABLEstructure. Therefore, the pBufpointer points to either PARSED_CONFIGor PARSED_CFTABLE.
If there are multiple CISTPL_CFTABLE_ENTRY tuples, this function retrieves the required number of PARSED_CFTABLEstructures, provided the user's buffer is large enough.
|Runs on||Versions||Defined in||Include||Link to|
|Windows CE OS||1.0 and later|
Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.
Last updated on Tuesday, July 13, 2004