CardRequestConfiguration (Windows CE 5.0)
This function sets socket attributes, interface type, voltage, and registers, as specified by the CARD_CONFIG_INFO structure.
STATUS CardRequestConfiguration(CARD_CLIENT_HANDLE hCardClient,PCARD_CONFIG_INFO pParms);
Parameters
- hCardClient
[in] Handle obtained from the CardRegisterClient function. - pParms
[in] Pointer to a CARD_CONFIG_INFO structure.
Return Values
CERR_SUCCESS indicates success. One of the following values indicates failure:
- CERR_BAD_ARGS
Indicates that the pointer specified for pParms is not valid. - CERR_BAD_HANDLE
Indicates that the driver specified for hCardClient is not valid. - CERR_BAD_SOCKET
Indicates that the socket identifier specified in the hSocket member of CARD_CONFIG_INFO is not valid or that a PC Card is not inserted. - CERR_BAD_VCC
Indicates that the voltage setting specified in the uVcc member of CARD_CONFIG_INFO is not valid. - CERR_BAD_VPP
Indicates that a voltage setting specified in the uVpp1 or **uVpp2****member of CARD_CONFIG_INFO is not valid. - CERR_IN_USE
Indicates that another driver owns the configuration. - CERR_READ_FAILURE
Indicates that this function is unable to read configuration registers. - CERR_WRITE_FAILURE
Indicates that this function is unable to write configuration registers.
Remarks
If power to the socket is off, CardRequestConfiguration turns it on.
Values specified in CARD_CONFIG_INFO are written to the card's configuration registers.
Setting the FCR_FCSR_PWR_DOWN bit in the FCSR register is equivalent to calling CardRequestConfiguration followed by CardPowerOff. The socket and function will be configured, but powered off.
Requirements
OS Versions: Windows CE 1.0 and later.
Header: Cardsv2.h.
Link Library: Pcc_serv.dll
See Also
CARD_CONFIG_INFO | CardReleaseConfiguration
Send Feedback on this topic to the authors