SDBUS_INTERFACE_PARAMETERS structure (ntddsd.h)
The SDBUS_INTERFACE_PARAMETERS structure contains the information necessary to initialize a Secure Digital (SD) card bus interface.
Syntax
typedef struct _SDBUS_INTERFACE_PARAMETERS {
USHORT Size;
USHORT SdioFlags;
PDEVICE_OBJECT TargetObject;
BOOLEAN DeviceGeneratesInterrupts;
BOOLEAN CallbackAtDpcLevel;
PSDBUS_CALLBACK_ROUTINE CallbackRoutine;
PVOID CallbackRoutineContext;
} SDBUS_INTERFACE_PARAMETERS, *PSDBUS_INTERFACE_PARAMETERS;
Members
Size
Indicates the size, in bytes, of this structure, including the area pointed to by the CallbackRoutineContext member.
SdioFlags
Reserved.
TargetObject
Pointer to the next lower device object in the device stack. The caller should initialize this member to point to the device object below the caller's device object in the device stack.
DeviceGeneratesInterrupts
Indicates, when TRUE, that the SD device generates interrupts. If FALSE, the device does not generate interrupts.
CallbackAtDpcLevel
Indicates, when TRUE, that the callback routine must run at DISPATCH_LEVEL. If FALSE, the callback must run at PASSIVE_LEVEL. A device driver can often lower the latency of interrupt delivery by setting this member to TRUE; however, drivers that set this value to TRUE must be able to run at both PASSIVE_LEVEL and DISPATCH_LEVEL.
CallbackRoutine
Pointer to a callback routine of type PSDBUS_CALLBACK_ROUTINE that the bus driver calls when a device interrupt occurs. If DeviceGeneratesInterrupts is not set to TRUE, then the bus driver ignores the value in this member.
CallbackRoutineContext
Pointer to the context information that the bus driver should pass to the callback routine when it dispatches a device interrupt.
Remarks
An SD device driver that obtains a bus interface instance from the bus driver must initialize the interface. After obtaining an interface instance, the device driver passes the data in the SDBUS_INTERFACE_PARAMETERS structure to the routine pointed to by the InitializeInterface member of the SDBUS_INTERFACE_STANDARD structure.
Requirements
Requirement | Value |
---|---|
Header | ntddsd.h |