1.1.6.4.4 DRV_SDMMC_Open Function

C

DRV_HANDLE DRV_SDMMC_Open (
    const SYS_MODULE_INDEX drvIndex,
    const DRV_IO_INTENT intent
);

Summary

Opens the specified SD Card driver instance and returns a handle to it.

Description

This routine opens the specified SDMMC driver instance and provides a handle that must be provided to all other client-level operations to identify the caller and the instance of the driver.

Precondition

Function DRV_SDMMC_Initialize must have been called before calling this function.

Parameters

ParamDescription
drvIndexIdentifier for the object instance to be opened
intentZero or more of the values from the enumeration DRV_IO_INTENT "ORed" together to indicate the intended use of the driver

Returns

If successful, the routine returns a valid open-instance handle (a number identifying both the caller and the module instance).

If an error occurs, the return value is DRV_HANDLE_INVALID.

Example

DRV_HANDLE handle;

handle = DRV_SDMMC_Open (DRV_SDMMC_INDEX_0, DRV_IO_INTENT_EXCLUSIVE);

if (handle == DRV_HANDLE_INVALID)
{
    // Unable to open the driver
}

Remarks

The handle returned is valid until the DRV_SDMMC_Close routine is called.