BUS_INTERFACE_STANDARD-Struktur (wdm.h)

Artikel
08/08/2023

Die BUS_INTERFACE_STANDARD-Schnittstellenstruktur ermöglicht Es Gerätetreibern, direkte Aufrufe an übergeordnete Bustreiberroutinen zu tätigen. Diese Struktur definiert die GUID_BUS_INTERFACE_STANDARD-Schnittstelle .

Syntax

typedef struct _BUS_INTERFACE_STANDARD {
  USHORT                 Size;
  USHORT                 Version;
  PVOID                  Context;
  PINTERFACE_REFERENCE   InterfaceReference;
  PINTERFACE_DEREFERENCE InterfaceDereference;
  PTRANSLATE_BUS_ADDRESS TranslateBusAddress;
  PGET_DMA_ADAPTER       GetDmaAdapter;
  PGET_SET_DEVICE_DATA   SetBusData;
  PGET_SET_DEVICE_DATA   GetBusData;
} BUS_INTERFACE_STANDARD, *PBUS_INTERFACE_STANDARD;

Member

Size

Die Größe (in Bytes) dieser Struktur.

Version

Die vom Treiber definierte Schnittstellenversion.

Context

Ein Zeiger auf schnittstellenspezifische Kontextinformationen.

InterfaceReference

Ein Zeiger auf eine InterfaceReference-Routine , die die Verweisanzahl der Schnittstelle erhöht.

InterfaceDereference

Ein Zeiger auf eine InterfaceDereference-Routine , die die Referenzanzahl der Schnittstelle verringert.

TranslateBusAddress

Ein Zeiger auf eine TranslateBusAddress-Routine , die Adressen auf dem übergeordneten Bus in logische Adressen übersetzt.

GetDmaAdapter

Ein Zeiger auf eine GetDmaAdapter-Routine , die eine DMA-Adapterstruktur (DMA_ADAPTER) für das Zielgerät zurückgibt.

SetBusData

Ein Zeiger auf eine SetBusData-Routine , die Daten in den Konfigurationsbereich des Geräts schreibt.

GetBusData

Ein Zeiger auf eine GetBusData-Routine , die Daten aus dem Konfigurationsbereich des Geräts liest.

Hinweise

Die BUS_INTERFACE_STANDARD-Struktur ist eine Erweiterung der INTERFACE-Struktur .

Einige Vorgänge auf einem Gerät sind für den übergeordneten Bustreiber des Geräts reserviert. Diese Vorgänge können den Zugriff auf den gerätespezifischen Konfigurationsraum eines Busses oder das Programmieren eines DMA-Controllers umfassen.

Um aus dem Konfigurationsraum eines Geräts zu lesen oder in diesen zu schreiben, muss sich ein Gerätetreiber auf zwei Arten auf die Agentur des Bustreibers verlassen:

Durch Senden der E/A-Anforderungspakete (IRPs) IRP_MN_READ_CONFIG und IRP_MN_WRITE_CONFIG an den Bustreiber.
Durch Abrufen einer Schnittstelle vom Bustreiber. Der Gerätetreiber kann dann auf den Konfigurationsraum seines Geräts zugreifen, indem er direkte Aufrufe an die Bustreiberroutinen durchführt, die von der BUS_INTERFACE_STANDARD-Schnittstellenstruktur bereitgestellt werden. Die Memberroutinen GetBusData und SetBusData können zum Lesen bzw. Schreiben in den Konfigurationsraum eines Geräts verwendet werden.

Weitere Informationen zu den Zugriffsmöglichkeiten auf den Konfigurationsbereich finden Sie unter Zugreifen auf den Konfigurationsbereich des Geräts.

Einige Gerätetypen, z. B. ein Busmasterspeichergerät, verfügen über DMA-Controller. Die Gerätetreiber für diese Geräte können diese DMA-Controller jedoch nicht direkt programmieren. Stattdessen müssen sie sich auf Routinen verlassen, die vom übergeordneten Bustreiber bereitgestellt werden. Damit ein Gerätetreiber den DMA-Controller für sein Gerät programmieren kann, muss er zuerst ein Adapterobjekt vom übergeordneten Bustreiber anfordern. Das Adapterobjekt enthält die vom Bustreiber bereitgestellten Routinen, die zum Programmieren des DMA-Controllers des Geräts verwendet werden können. Gerätetreiber müssen sich direkt oder indirekt auf den BUS_INTERFACE_STANDARD verlassen, um das Adapterobjekt abzurufen.

Wenn der Treiber unter IRQL = PASSIVE_LEVEL ausgeführt wird, sollte er das DMA-Adapterobjekt eines Geräts durch Aufrufen von IoGetDmaAdapter abrufen. IoGetDmaAdapter erkennt, ob der Bustreiber die BUS_INTERFACE_STANDARD-Schnittstelle unterstützt. Wenn dies der Fall ist, ruft IoGetDmaAdapter die Routine auf, auf die der GetDmaAdapter-Member dieser Schnittstelle verweist, um das Adapterobjekt abzurufen. Andernfalls ruft IoGetDmaAdapter eine entsprechende Legacyroutine auf.

Wenn ein Treiber jedoch ein Adapterobjekt abrufen muss, während er unter IRQL >= DISPATCH_LEVEL ausgeführt wird, kann er dies nicht mit IoGetDmaAdapter tun. In diesem Fall muss der Treiber die BUS_INTERFACE_STANDARD-Schnittstelle abfragen, während er noch bei IRQL = PASSIVE_LEVEL ist, indem er IRP_MN_QUERY_INTERFACE verwendet.