SD_SET_FEATURE_TYPE

Other versions of this page are also available for the following:

• Windows Embedded CE 6.0 R3

8/28/2008

This enumeration is used for setting secure digital card features using SDSetCardFeature.

Syntax

typedef enum {
  SD_IO_FUNCTION_ENABLE = 0,
  SD_IO_FUNCTION_DISABLE,
  SD_IO_FUNCTION_SET_BLOCK_SIZE,
  SD_SET_DATA_TRANSFER_CLOCKS,
  SD_SET_CARD_INTERFACE,
  SD_SET_CLOCK_STATE_DURING_IDLE,
  SD_IS_SOFT_BLOCK_AVAILABLE,
  SD_SOFT_BLOCK_FORCE_UTILIZATION,
  SD_SOFT_BLOCK_DEFAULT_UTILIZATON,
  SD_CARD_SELECT_REQUEST,
  SD_CARD_DESELECT_REQUEST,
  SD_CARD_FORCE_RESET,
  SD_IS_FAST_PATH_AVAILABLE,
  SD_FAST_PATH_DISABLE,
  SD_FAST_PATH_ENABLE,
  SD_IO_FUNCTION_HIGH_POWER,
  SD_IO_FUNCTION_LOW_POWER,
  SD_INFO_POWER_CONTROL_STATE,
  SD_SET_CARD_INTERFACE_EX,
  SD_SET_SWITCH_FUNCTION,
  SD_DMA_ALLOC_PHYS_MEM,
  SD_DMA_FREE_PHYS_MEM
} SD_SET_FEATURE_TYPE, *PSD_SET_FEATURE_TYPE;

Elements

• 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.**

Requirements

Header	sdcardddk.h
Windows Embedded CE	Windows CE 5.0 and later

See Also

Reference

Secure Digital Card Driver Enumerations