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

  • hCardClient
    Handle obtained from the CardRegisterClient function.
  • pParms
    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 invalid.
  • CERR_BAD_HANDLE
    Indicates that the driver specified for hCardClient is invalid.
  • CERR_BAD_SOCKET
    Indicates that the socket identifier specified in the hSocket member of CARD_CONFIG_INFO is invalid 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 invalid.
  • CERR_BAD_VPP
    Indicates that a voltage setting specified in the uVpp1 or uVpp2 member of CARD_CONFIG_INFO is invalid.
  • CERR_IN_USE
    Indicates that the configuration is owned by another driver.
  • 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.

Driver name

PCMCIA

Requirements

Runs on Versions Defined in Include Link to
Windows CE OS 1.0 and later      

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

CARD_CONFIG_INFO, CardReleaseConfiguration

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.