CardRequestConfiguration

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/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.