structure SDBUS_INTERFACE_STANDARD (ntddsd.h)
La structure SDBUS_INTERFACE_STANDARD contient des pointeurs vers les routines de méthode d’une interface de bus carte Secure Digital (SD).
Syntaxe
typedef struct _SDBUS_INTERFACE_STANDARD {
USHORT Size;
USHORT Version;
PVOID Context;
PINTERFACE_REFERENCE InterfaceReference;
PINTERFACE_DEREFERENCE InterfaceDereference;
PSDBUS_INITIALIZE_INTERFACE_ROUTINE InitializeInterface;
PSDBUS_ACKNOWLEDGE_INT_ROUTINE AcknowledgeInterrupt;
} SDBUS_INTERFACE_STANDARD, *PSDBUS_INTERFACE_STANDARD;
Membres
Size
Indique la taille, en octets, de cette structure. L’appelant de SdBusOpenInterface doit définir ce membre sur sizeof(SDBUS_INTERFACE_STANDARD).
Version
Indique le numéro de version de l’interface. L’appelant de SdBusOpenInterface doit définir ce membre sur SDBUS_INTERFACE_VERSION.
Context
Pointeur vers les informations de contexte fournies par le pilote de bus chaque fois qu’un pilote de périphérique ouvre une interface avec SdBusOpenInterface. Ces informations sont disponibles pour l’appelant sur la sortie après l’appel à SdBusOpenInterface. L’appelant doit passer ces informations en tant que paramètre à d’autres routines d’interface.
InterfaceReference
Pointeur vers une routine fournie par le pilote de bus de type PINTERFACE_REFERENCE qui incrémente le nombre de références de l’interface disponible pour l’appelant de la routine SdBusOpenInterface lorsque cette routine est retournée. SdBusOpenInterface incrémente automatiquement le nombre d’interfaces à un seul. Dans la plupart des cas, il est donc nécessaire que l’appelant utilise cette routine.
Cette routine suit le format standard des routines de référence d’interface de bus. Pour obtenir une description du cas général, consultez INTERFACE.
InterfaceDereference
Pointeur vers une routine fournie par le pilote de bus de type PINTERFACE_DEREFERENCE qui décrémente le nombre de références d’interface. Si l’appelant décrémente le nombre de références à zéro, le pilote de bus ferme l’interface.
Cette routine suit le format standard des routines de déréférencement de l’interface de bus. Pour obtenir une description du cas général, consultez INTERFACE.
Les pilotes de périphérique doivent utiliser cette routine pour déréférencer l’interface dans les conditions suivantes :
- Le pilote de périphérique reçoit un IRP de suppression de requête.
- Le pilote de périphérique reçoit un IRP de suppression surprise.
- Le pilote de périphérique reçoit un IRP de suppression, sans recevoir d’abord de suppression de requête ou d’IRP de suppression surprise.
Dans tous ces cas, le pilote de périphérique doit déréférencer l’interface avant de passer l’IRP au pilote de bus.
InitializeInterface
Pointeur vers une routine fournie par le pilote de bus de type PSDBUS_INITIALIZE_INTERFACE_ROUTINE qui définit les paramètres d’initialisation sur l’interface.
AcknowledgeInterrupt
Pointeur vers une routine fournie par le pilote de bus de type PSDBUS_ACKNOWLEDGE_INT_ROUTINE que le pilote de périphérique SD utilise pour avertir le pilote de bus qu’il a terminé le traitement d’une interruption.
Remarques
Les pilotes de périphérique SD doivent obtenir cet ensemble de routines de méthode pour communiquer avec le pilote de bus SD. Les pilotes appellent la routine de bibliothèque SdBusOpenInterface pour ouvrir une interface.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | ntddsdsd.h |