Funzione SdBusOpenInterface (ntddsd.h)
La routine SdBusOpenInterface ottiene un'interfaccia dal driver del bus Secure Digital (SD).
Sintassi
NTSTATUS SdBusOpenInterface(
[in] PDEVICE_OBJECT Pdo,
[out] PSDBUS_INTERFACE_STANDARD InterfaceStandard,
[in] USHORT Size,
[in] USHORT Version
);
Parametri
[in] Pdo
Puntatore all'oggetto dispositivo fisico creato dal driver del bus SD per il dispositivo SD gestito dal driver di dispositivo. Il sistema passa questo puntatore al driver di dispositivo quando chiama la routine addDevice del driver.
[out] InterfaceStandard
Contiene, in base all'input, un puntatore a una struttura di tipo SDBUS_INTERFACE_STANDARD fornita dal chiamante. In caso di output, questa struttura contiene puntatori alle routine dell'interfaccia del bus SD. Questa struttura contiene anche alcune informazioni di contesto nel relativo contesto membro che il chiamante deve passare ogni volta che chiama una routine di interfaccia.
[in] Size
Contiene le dimensioni, in byte, della struttura a cui punta InterfaceStandard.
[in] Version
Deve essere impostato su SDBUS_INTERFACE_VERSION.
Valore restituito
Restituisce STATUS_SUCCESS se l'operazione ha esito positivo o il codice di errore appropriato se l'operazione ha esito negativo.
Osservazioni
Un driver della scheda SD deve chiamare questa routine dalla routine AddDevice.
I conducenti di schede SD devono chiamare questa routine per stabilire la comunicazione con il conducente del bus. Al termine di questa chiamata, il Context membro della struttura a cui punta InterfaceStandard conterrà un handle che il driver deve passare quando si chiamano metodi appartenenti all'interfaccia recuperata.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Desktop |
| intestazione | ntddsd.h (include Ntddsd.h) |
| IRQL | < DISPATCH_LEVEL |