Share via


SDSetCardFeature (Windows Embedded CE 6.0)

1/6/2010

This function sets various SDIO card features in a thread-safe manner.

Syntax

SD_API_STATUS SDSetCardFeature(
  SD_DEVICE_HANDLE hDevice,
  SD_SET_FEATURE_TYPE CardFeature,
  PVOID pCardInfo,
  ULONG StructureSize
);

Parameters

  • hDevice
    [in] Handle to an SD bus device.
  • CardFeature
    [in] Card feature to set.
  • pCardInfo
    [in] Buffer containing new data for the feature.
  • StructureSize
    [in] Size of the pCardInfo structure.

The following table shows the possible values for the CardFeature and pCardInfo parameters.

CardFeature value Description

SD_IO_FUNCTION_ENABLE

Enables the current function. The SD_IO_FUNCTION_ENABLE_INFO value defines a retry interval and maximum retry count to check for correct function activation.

SD_IO_FUNCTION_DISABLE

Disables the current function.

SD_IO_FUNCTION_SET_BLOCK_SIZE

Sets the block size for the IO_RW_EXTENDED command.

SD_SET_DATA_TRANSFER_CLOCKS

Sets the current read/write data access delay used by a host controller driver when calculating an appropriate read or write data timeout. This value is optional, and a client driver can rely on the host controller driver to implement proper timeouts.

SD_SET_CARD_INTERFACE

Allows a client driver to set the bus width and clock rate for a card. The client driver should first query the host interface capabilities The ClockRate field will be modified by the host controller driver to reflect the actual clock rate used. The client driver should not assume that it can set an exact clock rate.

SD_SET_CLOCK_STATE_DURING_IDLE

Sets the clock state during the idle state.

SD_IS_SOFT_BLOCK_AVAILABLE

Determines if Soft-Block is available in the SD bus driver.

SD_SOFT_BLOCK_FORCE_UTILIZATION

Always use Soft-Block. This value is for testing purposes only.

SD_SOFT_BLOCK_DEFAULT_UTILIZATION

Always use hardware multi-block operation if supported by the card, otherwise use Soft-Block.

SD_CARD_SELECT_REQUEST

Requests the card to be selected.

SD_CARD_DESELECT_REQUEST

Requests the card to be deselected.

SD_CARD_FORCE_RESET

Forces the card to be reset.

SD_IS_FAST_PATH_AVAILABLE

Determines if Fast-Path is available in the SD bus driver.

SD_FAST_PATH_DISABLE

Disables the use of Fast-Path. This value is for testing purposes only.

SD_FAST_PATH_ENABLE

Enables the use of Fast-Path.

SD_IO_FUNCTION_HIGH_POWER

Selects high power mode for function.

SD_IO_FUNCTION_LOW_POWER

Selects low power mode for function.

SD_INFO_POWER_CONTROL_STATE

Retrieves the power state of a function.

SD_SET_CARD_INTERFACE_EX

Applies to Windows Embedded CE 6.0 R2

Allows a client driver to set the bus width, clock rate, and enable high speed for a card. The client driver should first query the host interface capabilities. The ClockRate field will be modified by the host controller driver to reflect the actual clock rate used. The client driver should not assume that it can set an exact clock rate. Note that this value is an extension for SD_CARD_INTERFACE.

SD_SET_SWITCH_FUNCTION

Applies to Windows Embedded CE 6.0 R2

Sets the SD card switch function.

SD_DMA_ALLOC_PHYS_MEM

Applies to Windows Embedded CE 6.0 R2

Allows a client driver to allocate a physical buffer with the given size and to take advantage of using direct memory access (DMA).

SD_DMA_FREE_PHYS_MEM

Applies to Windows Embedded CE 6.0 R2

Allows a client driver to free the DMA buffer that was allocated using SD_DMA_ALLOC_PHYS_MEM.

Return Value

A return value of type SD_API_STATUS indicates the success or failure.

Remarks

This function is provided to set various SDIO card features in a thread-safe manner. SDIO cards utilize shared register sets between functions. This requires that the register state be preserved between functions that can be controlled in separate thread contexts. This function can block by issuing synchronous bus request.

Note

This function must not be called from a bus request callback.

Requirements

Header sdcardddk.h
Library sdcardlib.lib
Windows Embedded CE Windows CE 5.0 and later

See Also

Reference

Secure Digital Card Driver Functions