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

另请参阅

接口

PSDBUS_ACKNOWLEDGE_INT_ROUTINE

SDBUS_INTERFACE_STANDARD

SdBusOpenInterface