CardRequestConfiguration

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

hCardClient
Client 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_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

See Also

CARD_CONFIG_INFO, CardReleaseConfiguration