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

See also

PSDBUS_CALLBACK_ROUTINE

SDBUS_INTERFACE_STANDARD