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