CONTROLLER_OBJECT-Struktur (ntddk.h)

Ein Controllerobjekt stellt einen Hardwareadapter oder Controller mit homogenen Geräten dar, die die eigentlichen Ziele für E/A-Anforderungen sind. Ein Controllerobjekt kann verwendet werden, um die E/A eines Gerätetreibers mit den Zielgeräten über seinen Hardwareadapter/Controller zu synchronisieren.

Ein Controllerobjekt ist teilweise undurchsichtig. Treiberautoren müssen über ein bestimmtes Feld bescheid wissen, das dem Controllerobjektobjekt zugeordnet ist, da ihre Treiber über den von IoCreateController zurückgegebenen Controllerobjektzeiger auf dieses Feld zugreifen. Auf das folgende Feld in einem Controllerobjekt kann der erstellende Treiber zugreifen.

Syntax

typedef struct _CONTROLLER_OBJECT {
  CSHORT        Type;
  CSHORT        Size;
  PVOID         ControllerExtension;
  KDEVICE_QUEUE DeviceWaitQueue;
  ULONG         Spare1;
  LARGE_INTEGER Spare2;
} CONTROLLER_OBJECT, *PCONTROLLER_OBJECT;

Member

Type

Size

ControllerExtension

Zeiger auf die Controllererweiterung. Die Struktur und der Inhalt der Controllererweiterung sind treiberdefiniert. Die Größe wird vom Treiber bestimmt, die im Aufruf von IoCreateController des Treibers angegeben wird. In der Regel behalten Treiber den allgemeinen Zustand über E/A-Vorgänge in der Controllererweiterung und den gerätespezifischen Zustand über E/A für ein Zielgerät in der entsprechenden Geräteerweiterung bei.

DeviceWaitQueue

Spare1

Spare2

Hinweise

Die meisten Treiberroutinen, die IRPs verarbeiten, erhalten einen Zeiger auf das Zielgerätobjekt. Daher speichern Gerätetreiber, die Controllerobjekte verwenden, häufig den von IoCreateController zurückgegebenen Controllerobjektzeiger in jeder Geräteerweiterung.

Beachten Sie, dass ein Controllerobjekt keinen Namen hat, sodass es nicht das Ziel einer E/A-Anforderung sein kann, und dass treiber auf höherer Ebene keine Verbindung herstellen oder ihre Geräteobjekte an das Controllerobjekt eines Gerätetreibers anfügen können.

Nicht dokumentierte Felder in einem Controllerobjekt sollten als nicht zugänglich betrachtet werden. Treiber mit Abhängigkeiten von Objektfeldstandorten oder Zugriff auf nicht dokumentierte Felder bleiben möglicherweise nicht portabel und interoperabel mit anderen Treibern im Laufe der Zeit.

Anforderungen

Weitere Informationen

IoCreateController