struttura SDBUS_INTERFACE_STANDARD (ntddsd.h)
La struttura SDBUS_INTERFACE_STANDARD contiene puntatori alle routine del metodo di un'interfaccia del bus di scheda Secure Digital (SD).
Sintassi
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;
Membri
Size
Indica le dimensioni, in byte, di questa struttura. Il chiamante di SdBusOpenInterface deve impostare questo membro su sizeof(SDBUS_INTERFACE_STANDARD).
Version
Indica il numero di versione dell'interfaccia. Il chiamante di SdBusOpenInterface deve impostare questo membro su SDBUS_INTERFACE_VERSION.
Context
Puntatore alle informazioni di contesto fornite dal driver del bus ogni volta che un driver di dispositivo apre un'interfaccia con SdBusOpenInterface. Queste informazioni sono disponibili per il chiamante sull'output dopo la chiamata a SdBusOpenInterface. Il chiamante deve passare queste informazioni come parametro ad altre routine di interfaccia.
InterfaceReference
Puntatore a una routine fornita dal driver del bus di tipo PINTERFACE_REFERENCE che incrementa il conteggio dei riferimenti dell'interfaccia disponibile per il chiamante del SdBusOpenInterface routine quando questa routine viene restituita. SdBusOpenInterface incrementa automaticamente il numero di interfacce a uno, quindi nella maggior parte dei casi, è necessario che il chiamante usi questa routine.
Questa routine segue il formato standard delle routine di riferimento dell'interfaccia del bus. Per una descrizione del caso generale, vedere INTERFACE.
InterfaceDereference
Puntatore a una routine fornita dal driver del bus di tipo PINTERFACE_DEREFERENCE che decrementa il conteggio dei riferimenti dell'interfaccia. Se il chiamante decrementa il conteggio dei riferimenti a zero, il conducente del bus chiude l'interfaccia.
Questa routine segue il formato standard delle routine di dereferenziazione dell'interfaccia del bus. Per una descrizione del caso generale, vedere INTERFACE.
I driver di dispositivo devono usare questa routine per dereferenziare l'interfaccia nelle condizioni seguenti:
- Il driver di dispositivo riceve una query che rimuove IRP.
- Il driver di dispositivo riceve una rimozione a sorpresa di IRP.
- Il driver di dispositivo riceve una rimozione di IRP, senza prima ricevere una rimozione di una query o una rimozione a sorpresa di IRP.
In tutti questi casi, il driver di dispositivo deve dereferenziare l'interfaccia prima di passare l'IRP al conducente del bus.
InitializeInterface
Puntatore a una routine fornita dal driver del bus di tipo PSDBUS_INITIALIZE_INTERFACE_ROUTINE che imposta i parametri di inizializzazione nell'interfaccia.
AcknowledgeInterrupt
Puntatore a una routine fornita dal driver del bus di tipo PSDBUS_ACKNOWLEDGE_INT_ROUTINE che il driver di dispositivo SD usa per notificare al driver del bus che ha terminato l'elaborazione di un interrupt.
Osservazioni
I driver di dispositivo SD devono ottenere questo set di routine del metodo per comunicare con il driver del bus SD. I driver chiamano la routine della libreriasdBusOpenInterfaceper aprire un'interfaccia.
Fabbisogno
| Requisito | Valore |
|---|---|
| intestazione | ntddsd.h |