Share via

CardRequestConfiguration

  • Article

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

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/function will be configured, but powered off.

Requirements

OS Versions: Windows CE 1.0 and later.
Header: Cardserv.h.
Link Library: Cardserv.lib.

See Also

CARD_CONFIG_INFO | CardReleaseConfiguration

 Last updated on Tuesday, May 18, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.