SdBusOpenInterface 函数 (ntddsd.h)

SdBusOpenInterface 例程从安全数字(SD)总线驱动程序获取接口。

语法

NTSTATUS SdBusOpenInterface(
  [in]  PDEVICE_OBJECT            Pdo,
  [out] PSDBUS_INTERFACE_STANDARD InterfaceStandard,
  [in]  USHORT                    Size,
  [in]  USHORT                    Version
);

参数

[in] Pdo

指向为设备驱动程序管理的 SD 设备创建的 SD 总线驱动程序的物理设备对象的指针。 当系统调用驱动程序的 AddDevice 例程时,系统会将此指针传递给设备驱动程序。

[out] InterfaceStandard

在输入中,包含指向调用方提供的 SDBUS_INTERFACE_STANDARD 类型的结构的指针。 在输出中,此结构保存指向 SD 总线接口例程的指针。 此结构还包含其 上下文 成员中的一些上下文信息,调用方每次调用接口例程时都应传入该成员。

[in] Size

包含 InterfaceStandard指向的结构的大小(以字节为单位)。

[in] Version

必须设置为SDBUS_INTERFACE_VERSION。

返回值

如果作成功,则返回STATUS_SUCCESS;如果作失败,则返回相应的错误代码。

言论

SD 卡驱动程序应从其 AddDevice 例程调用此例程。

SD 卡驱动程序必须调用此例程才能与总线驱动程序建立通信。 成功完成此调用后,InterfaceStandard 指向的结构 上下文 成员将包含驱动程序在调用属于检索接口的方法时必须传入的句柄。

要求

要求 价值
目标平台 桌面
标头 ntddsd.h (包括 Ntddsd.h)
IRQL < DISPATCH_LEVEL

另请参阅

AddDevice

SDBUS_INTERFACE_STANDARD