struttura SDCMD_DESCRIPTOR (sddef.h)

Articolo
02/07/2025

La struttura SDCMD_DESCRIPTOR definisce un comando di scheda Secure Digital (SD).

Sintassi

typedef struct _SDCMD_DESCRIPTOR {
  SD_COMMAND_CODE       Cmd;
  SD_COMMAND_CLASS      CmdClass;
  SD_TRANSFER_DIRECTION TransferDirection;
  SD_TRANSFER_TYPE      TransferType;
  SD_RESPONSE_TYPE      ResponseType;
} SDCMD_DESCRIPTOR, *PSDCMD_DESCRIPTOR;

Membri

Cmd

Contiene un valore di tipo SD_COMMAND_CODE che specifica il comando SD. cmd può essere uno dei valori seguenti.

Valore	Significato
SDCMD_IO_RW_DIRECT	Indica un'operazione di lettura o scrittura di un singolo byte.
SDCMD_IO_RW_EXTENDED	Indica un'operazione di lettura o scrittura in un buffer in memoria.

CmdClass

Contiene un valore di enumerazione di tipo SD_COMMAND_CLASS che specifica la classe del comando SD.

TransferDirection

Contiene un valore di enumerazione di tipo SD_TRANSFER_DIRECTION che indica la direzione del trasferimento dei dati.

TransferType

Contiene un valore di enumerazione di tipo SD_TRANSFER_TYPE che indica il tipo di trasferimento dei dati.

ResponseType

Contiene un valore di enumerazione di tipo SD_RESPONSE_TYPE che indica il tipo di risposta inviato dalla scheda in risposta al comando indicato nel membro Cmd.

Osservazioni

Per inviare un comando a un dispositivo SD, un driver di dispositivo deve completare i passaggi seguenti:

Impostare il membro RequestFunction di SDBUS_REQUEST_PACKET su un valore di enumerazione SD_REQUEST_FUNCTION di SDRF_DEVICE_COMMAND.
Inizializzare il membro cmdDesc di di SDBUS_REQUEST_PACKET per definire il comando.
Inviare la richiesta al driver del bus passando la struttura di SDBUS_REQUEST_PACKET inizializzata a SdBusSubmitRequest o SdBusSubmitRequestAsync.

Se un driver invia una richiesta di comando senza inizializzare correttamente il TransferDirection, TransferTypee ResponseType membri del descrittore di comando, la richiesta avrà esito negativo. Questi membri non possono essere 0.