структура SDBUS_INTERFACE_STANDARD (ntddsd.h)
Структура SDBUS_INTERFACE_STANDARD содержит указатели на подпрограммы метода интерфейса secure Digital (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 автоматически увеличивает число интерфейсов до единицы, поэтому в большинстве случаев вызывающему объекту необходимо использовать эту подпрограмму.
Эта подпрограмма соответствует стандартному формату эталонных процедур интерфейса шины. Описание общего случая см. в разделе INTERFACE.
InterfaceDereference
Указатель на подпрограмму, предоставляемую водителем шины, типа PINTERFACE_DEREFERENCE, которая уменьшает количество ссылок на интерфейс. Если вызывающий объект уменьшает количество ссылок до нуля, водитель шины закрывает интерфейс.
Эта подпрограмма соответствует стандартному формату процедур разыменования интерфейса шины. Описание общего случая см. в разделе INTERFACE.
Драйверы устройств должны использовать эту подпрограмму для разыменования интерфейса при следующих условиях:
- Драйвер устройства получает запрос на удаление IRP.
- Драйвер устройства получает неожиданное удаление IRP.
- Драйвер устройства получает IRP удаления, не получая запроса на удаление или неожиданное удаление IRP.
Во всех этих случаях драйвер устройства должен разыменовать интерфейс перед передачей IRP водителю шины.
InitializeInterface
Указатель на подпрограмму, предоставляемую водителем шины, типа PSDBUS_INITIALIZE_INTERFACE_ROUTINE , которая задает параметры инициализации в интерфейсе.
AcknowledgeInterrupt
Указатель на подпрограмму, предоставляемую водителем шины, типа PSDBUS_ACKNOWLEDGE_INT_ROUTINE , которую драйвер устройства SD использует для уведомления водителя автобуса о том, что он завершил обработку прерывания.
Комментарии
Драйверы sd-устройств должны получить этот набор процедур метода для взаимодействия с драйвером шины SD. Драйверы вызывают подпрограмму библиотеки SdBusOpenInterface , чтобы открыть интерфейс.
Требования
| Требование | Значение |
|---|---|
| Заголовок | ntddsd.h |