SDBUS_INTERFACE_STANDARD 结构 (ntddsd.h)
SDBUS_INTERFACE_STANDARD 结构包含指向安全数字 (SD) 卡 总线接口的方法例程的指针。
语法
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
指示此结构的大小(以字节为单位)。 SdBusOpenInterface 的调用方应将此成员设置为 sizeof (SDBUS_INTERFACE_STANDARD) 。
Version
指示接口的版本号。 SdBusOpenInterface 的调用方应将此成员设置为 SDBUS_INTERFACE_VERSION。
Context
指向设备驱动程序使用 SdBusOpenInterface 打开接口时总线驱动程序提供的上下文信息的指针。 调用 SdBusOpenInterface 后,调用方可在输出中获取此信息。 调用方必须将此信息作为参数传递给其他接口例程。
InterfaceReference
指向总线驱动程序提供的 PINTERFACE_REFERENCE 类型的例程的指针,该例程返回时,该例程会递增接口的引用计数,该引用计数可供 SdBusOpenInterface 例程的调用方使用。 SdBusOpenInterface 自动将接口计数递增为 1,因此在大多数情况下,调用方必须使用此例程。
此例程遵循总线接口引用例程的标准格式。 有关一般情况的说明,请参阅 INTERFACE。
InterfaceDereference
指向总线驱动程序提供的 PINTERFACE_DEREFERENCE 类型的例程的指针,该例程会递减接口引用计数。 如果调用方将引用计数递减为零,则总线驱动程序将关闭接口。
此例程遵循总线接口取消引用例程的标准格式。 有关一般情况的说明,请参阅 INTERFACE。
在以下情况下,设备驱动程序必须使用此例程取消引用接口:
- 设备驱动程序收到查询删除 IRP。
- 设备驱动程序收到意外删除 IRP。
- 设备驱动程序接收删除 IRP,而无需先接收查询删除或意外删除 IRP。
在所有这些情况下,设备驱动程序应在将 IRP 传递给总线驱动程序之前取消引用接口。
InitializeInterface
指向总线驱动程序提供的 PSDBUS_INITIALIZE_INTERFACE_ROUTINE 类型的例程的指针,该例程在接口上设置初始化参数。
AcknowledgeInterrupt
指向 PSDBUS_ACKNOWLEDGE_INT_ROUTINE类型的总线 驱动程序提供的例程的指针,SD 设备驱动程序使用该例程通知总线驱动程序它已完成处理中断。
注解
SD 设备驱动程序必须获取这组方法例程才能与 SD 总线驱动程序通信。 驱动程序调用 SdBusOpenInterface 库例程以打开接口。
要求
要求 | 值 |
---|---|
Header | ntddsd.h |