SdBusOpenInterface 函式 (ntddsd.h)
SdBusOpenInterface 例程會從 Secure Digital (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 總線介面例程的指標。 這個結構也會在其 Context 成員中包含一些內容資訊,呼叫端每次呼叫介面例程時都應該傳入。
[in] Size
包含 InterfaceStandard 所指向之結構的大小,以位元組為單位。
[in] Version
必須設定為 SDBUS_INTERFACE_VERSION。
傳回值
如果作業成功,則傳回STATUS_SUCCESS,如果作業失敗,則傳回適當的錯誤碼。
備註
SD 記憶卡驅動程序應該從其 AddDevice 例程呼叫此例程。
SD 記憶卡驅動程式必須呼叫此例程,才能建立與總線驅動程序的通訊。 成功完成此呼叫時,InterfaceStandard 所指向結構的 Context 成員將包含驅動程式在呼叫屬於所擷取介面的方法時必須傳入的句柄。
規格需求
需求 | 值 |
---|---|
目標平台 | 桌面 |
標頭 | ntddsd.h (包含 Ntddsd.h) |
IRQL | < DISPATCH_LEVEL |