Share via

CardRequestConfiguration (Windows Embedded CE 6.0)

  • Article

1/6/2010

This function sets socket attributes, interface type, voltage, and registers, as specified by the CARD_CONFIG_INFO structure.

Syntax

STATUS CardRequestConfiguration(
  CARD_CLIENT_HANDLE hCardClient,
  PCARD_CONFIG_INFO pParms 
);

Parameters

Return Value

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 uVpp2member 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

Header cardsv2.h
Library Pcc_serv.dll
Windows Embedded CE Windows CE 1.0 and later

See Also

Reference

PC Card Driver Functions
CARD_CONFIG_INFO
CardReleaseConfiguration