Fonction SdBusOpenInterface (ntddsdsd.h)
La routine SdBusOpenInterface obtient une interface à partir du pilote de bus Secure Digital (SD).
Syntaxe
NTSTATUS SdBusOpenInterface(
[in] PDEVICE_OBJECT Pdo,
[out] PSDBUS_INTERFACE_STANDARD InterfaceStandard,
[in] USHORT Size,
[in] USHORT Version
);
Paramètres
[in] Pdo
Pointeur vers l’objet de périphérique physique que le pilote de bus SD a créé pour le périphérique SD que le pilote de périphérique gère. Le système transmet ce pointeur au pilote de périphérique lorsqu’il appelle la routine AddDevice du pilote.
[out] InterfaceStandard
Contient, en entrée, un pointeur vers une structure de type SDBUS_INTERFACE_STANDARD fournie par l’appelant. Sur la sortie, cette structure contient des pointeurs vers les routines d’interface du bus SD. Cette structure contient également des informations de contexte dans son membre Context que l’appelant doit transmettre chaque fois qu’il appelle une routine d’interface.
[in] Size
Contient la taille, en octets, de la structure pointée vers interfaceStandard.
[in] Version
Doit être défini sur SDBUS_INTERFACE_VERSION.
Valeur retournée
Retourne STATUS_SUCCESS si l’opération réussit ou le code d’erreur approprié si l’opération échoue.
Remarques
Un pilote SD carte doit appeler cette routine à partir de sa routine AddDevice.
Les pilotes SD carte doivent appeler cette routine pour établir la communication avec le pilote de bus. Une fois cet appel terminé, le membre context de la structure pointée par InterfaceStandard contient un handle que le pilote doit transmettre lors de l’appel de méthodes qui appartiennent à l’interface récupérée.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | ntddsdsd.h (inclure Ntddsd.h) |
| IRQL | < DISPATCH_LEVEL |