Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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