SDBUS_INTERFACE_STANDARD-Struktur (ntddsd.h)
Die SDBUS_INTERFACE_STANDARD-Struktur enthält Zeiger auf die Methodenroutinen einer Secure Digital-schnittstelle (SD) Karte Busschnittstelle.
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;
Size
Gibt die Größe dieser Struktur in Bytes an. Der Aufrufer von SdBusOpenInterface sollte diesen Member auf sizeof(SDBUS_INTERFACE_STANDARD) festlegen.
Version
Gibt die Versionsnummer der Schnittstelle an. Der Aufrufer von SdBusOpenInterface sollte diesen Member auf SDBUS_INTERFACE_VERSION festlegen.
Context
Zeiger auf Kontextinformationen, die der Bustreiber bereitstellt, wenn ein Gerätetreiber eine Schnittstelle mit SdBusOpenInterface öffnet. Diese Informationen stehen dem Aufrufer bei der Ausgabe nach dem Aufruf von SdBusOpenInterface zur Verfügung. Der Aufrufer muss diese Informationen als Parameter an andere Schnittstellenroutinen übergeben.
InterfaceReference
Zeiger auf eine vom Bustreiber bereitgestellte Routine vom Typ PINTERFACE_REFERENCE, die die Referenzanzahl der Schnittstelle erhöht, die dem Aufrufer der SdBusOpenInterface-Routine zur Verfügung steht, wenn diese Routine zurückgibt. SdBusOpenInterface erhöht die Anzahl der Schnittstellen automatisch auf eins, sodass der Aufrufer in den meisten Fällen diese Routine verwenden muss.
Diese Routine folgt dem Standardformat der Referenzroutinen für Busschnittstellen. Eine Beschreibung des allgemeinen Falls finden Sie unter INTERFACE.
InterfaceDereference
Zeiger auf eine vom Bustreiber bereitgestellte Routine vom Typ PINTERFACE_DEREFERENCE, die die Anzahl der Schnittstellenverweis verringert. Wenn der Aufrufer die Verweisanzahl auf 0 (null) verringert, schließt der Bustreiber die Schnittstelle.
Diese Routine folgt dem Standardformat der Dereferenzierungsroutinen für Busschnittstellen. Eine Beschreibung des allgemeinen Falls finden Sie unter INTERFACE.
Gerätetreiber müssen diese Routine verwenden, um die Schnittstelle unter den folgenden Bedingungen zu dereferenzieren:
- Der Gerätetreiber empfängt eine Abfrage zum Entfernen von IRP.
- Der Gerätetreiber erhält eine überraschungsferne IRP.
- Der Gerätetreiber empfängt ein IRP zum Entfernen, ohne zuerst eine Abfrage zu entfernen oder eine Überraschungs-IRP zu entfernen.
In all diesen Fällen sollte der Gerätetreiber die Schnittstelle dereferenzieren, bevor der IRP an den Bustreiber übergeben wird.
InitializeInterface
Zeiger auf eine vom Bustreiber bereitgestellte Routine vom Typ PSDBUS_INITIALIZE_INTERFACE_ROUTINE , die Initialisierungsparameter auf der Schnittstelle festlegt.
AcknowledgeInterrupt
Zeiger auf eine vom Bustreiber bereitgestellte Routine vom Typ PSDBUS_ACKNOWLEDGE_INT_ROUTINE , die der SD-Gerätetreiber verwendet, um den Bustreiber zu benachrichtigen, dass die Verarbeitung eines Interrupts abgeschlossen ist.
SD-Gerätetreiber müssen diese Methodenroutinen abrufen, um mit dem SD-Bustreiber zu kommunizieren. Treiber rufen die Bibliotheksroutine SdBusOpenInterface auf, um eine Schnittstelle zu öffnen.
Anforderung | Wert |
---|---|
Header | ntddsd.h |