structure SDCMD_DESCRIPTOR (sddef.h)

Article
02/29/2024

La structure SDCMD_DESCRIPTOR définit une commande de carte SD (Secure Digital).

Syntaxe

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;

Membres

Cmd

Contient une valeur de type SD_COMMAND_CODE qui spécifie la commande SD. Cmd peut être l’une des valeurs suivantes.

Valeur	Signification
SDCMD_IO_RW_DIRECT	Indique une opération de lecture ou d’écriture d’un seul octet.
SDCMD_IO_RW_EXTENDED	Indique une opération de lecture ou d’écriture sur une mémoire tampon.

CmdClass

Contient une valeur d’énumération de type SD_COMMAND_CLASS qui spécifie la classe de la commande SD.

TransferDirection

Contient une valeur d’énumération de type SD_TRANSFER_DIRECTION qui indique le sens du transfert de données.

TransferType

Contient une valeur d’énumération de type SD_TRANSFER_TYPE qui indique le type du transfert de données.

ResponseType

Contient une valeur d’énumération de type SD_RESPONSE_TYPE qui indique le type de réponse que le carte envoie en réponse à la commande indiquée dans le membre Cmd.

Remarques

Pour envoyer une commande à un appareil SD, un pilote de périphérique doit effectuer les étapes suivantes :

Définissez le membre RequestFunction de SDBUS_REQUEST_PACKET sur une valeur d’énumération SD_REQUEST_FUNCTION de SDRF_DEVICE_COMMAND.
Initialisez le membre CmdDesc de SDBUS_REQUEST_PACKET pour définir la commande.
Envoyez la demande au pilote de bus en passant la structure SDBUS_REQUEST_PACKET initialisée à SdBusSubmitRequest ou SdBusSubmitRequestAsync.

Si un pilote envoie une demande de commande sans initialiser correctement les membres TransferDirection, TransferType et ResponseType du descripteur de commande, la demande échoue. Ces membres ne peuvent pas être 0.