SDSynchronousBusRequest (Compact 2013)
3/26/2014
This function synchronously issues a bus request to a secure digital (SD) device.
Syntax
SD_API_STATUS SDSynchronousBusRequest(
SD_DEVICE_HANDLE hHandle,
UCHAR Command,
DWORD Argument,
SD_TRANSFER_CLASS TransferClass,
SD_RESPONSE_TYPE ResponseType,
PSD_COMMAND_RESPONSE pResponse,
ULONG NumBlocks,
ULONG BlockSize,
PUCHAR pBuffer,
DWORD Flags
);
Parameters
- hHandle
[in] Handle to an SD bus device.
- Command
[in] SD command to be sent to the device.
- Argument
[in] 32-bit argument specific to the command.
- TransferClass
[in] Specifies whether the transaction will read data (SD_READ), write data (SD_WRITE) or is command only (SD_COMMAND).
- ResponseType
[in] Specifies the type of response expected to the command.
- pResponse
[out] Pointer to an SD_COMMAND_RESPONSE structure to hold the response from the SD device.
- NumBlocks
[in] Specifies the number of data blocks provided to send or receive data. Can be set to zero if TransferClass is SD_COMMAND.
- BlockSize
[in] Specifies the size of the data blocks provided to send or receive data. Can be set to zero if TransferClass is SD_COMMAND.
- pBuffer
[in, out] Pointer to buffer for sending or receiving data. Can be set to NULL if TransferClass is SD_COMMAND.
Flags
[in] Optional. Bus request flags. The following table shows the possible values for Flags.Value
Description
SD_AUTO_ISSUE_CMD12
Informs the bus driver to issue the CMD12 SD command to stop transmission after the bus request completes. This flag should only be used in conjunction to a CMD18 or CMD25 bus request, which requires a CMD12 to instruct the card to stop transmission. The client driver should not use this option on any other command type.
SD_SDIO_AUTO_IO_ABORT
Informs the bus driver to perform the abort I/O procedure, using CMD52, for the I/O function receiving the request. The abort procedure is used in conjunction with CMD53 when the number of blocks in the command argument is set to zero. This value in the command argument instructs the I/O function to transmit or receive data until an I/O abort is issued. The client driver should not use this option on any other command type.
Return Value
A return value of type SD_API_STATUS indicates the success or failure of the transaction initiation.
Remarks
If a card is set to application command (ACMD) mode using CMD13, the client driver must issue the next command for ACMD mode. The client driver should not call other SD APIs while in ACMD mode as these APIs may send commands to the card that can be misinterpreted as ACMD commands.
Requirements
Header |
sdcardddk.h |
Library |
sdcardlib.lib |