Freigeben über

SerCx2 Objekthandles

In diesem Thema werden Objekthandletypen beschrieben, die speziell für Version 2 der seriellen Frameworkerweiterung (SerCx2) definiert sind.

Die SerCx2-Gerätetreiberschnittstelle (DDI) verwendet diese Handletypen, um auf Objekte zu verweisen, die features und Funktionen aufweisen, die für SerCx2 spezifisch sind.

Darüber hinaus verwendet der SerCx2 DDI zwei der generischen Objekthandletypen WDFDEVICE und WDFREQUEST, die vom Kernel-Mode Driver Framework (KMDF) definiert werden.

Weitere Informationen zu Framework-Handle-Typen finden Sie in der Zusammenfassung von Framework-Objekten.

In diesem Thema werden die folgenden Objekthandles beschrieben:

Kopfzeile: 2.0\Sercx.h

SERCX2CUSTOMRECEIVE-Objekthandle

Ein SERCX2CUSTOMRECEIVE-Objekthandle ist ein opaker Verweis auf ein benutzerdefiniertes Empfangsobjekt in Version 2 der Serial Frameworkerweiterung (SerCx2).

Die SerCx2CustomReceiveCreate-Methode erstellt ein objekt für den benutzerdefinierten Empfang. SerCx2 verwendet dieses Objekt zum Verwalten von E/A-Transaktionen, die einen benutzerdefinierten Datenübertragungsmechanismus verwenden, um Daten vom seriellen Controller zu lesen. Dieses Objekt ist für serielle Controllertreiber nicht transparent.

SerCx2CustomReceiveCreate stellt als Ausgabeparameter ein SERCX2CUSTOMRECEIVE Handle für das neu erstellte benutzerdefinierte Empfangsobjekt bereit.

SerCx2 und der serielle Controllertreiber verwenden dieses Handle, um in nachfolgenden Aufrufen von SerCx2-Methoden und Ereignisrückruffunktionen auf das Objekt zu verweisen.

Nachdem SerCx2CustomReceiveCreate das objekt für den benutzerdefinierten Empfang erstellt hat, ist dieses Objekt für die Lebensdauer des Framework-Geräteobjekts vorhanden, das das serielle Controllergerät darstellt. Das objekt für den benutzerdefinierten Empfang wird automatisch gelöscht, wenn das Geräteobjekt gelöscht wird. Der treiber des seriellen Controllers darf nicht versuchen, das objekt für den benutzerdefinierten Empfang durch Aufrufen einer Methode wie WdfObjectDelete zu löschen.

Ein serieller Controllertreiber kann als Option ein objekt für den benutzerdefinierten Empfang erstellen, aber nicht mehr als ein solches Objekt erstellen.

Der Treiber kann dieses Objekt nur unter den folgenden Bedingungen erstellen:

  • Der Treiber hat zuvor ein PIO-Empfangsobjekt erstellt.
  • Der Treiber hat kein System-DMA-Empfangsobjekt erstellt.

Weitere Informationen zu PIO-Empfangsobjekten finden Sie unter SERCX2PIORECEIVE Object Handle.

Weitere Informationen zu System-DMA-Empfangsobjekten finden Sie unter SERCX2SYSTEMDMARECEIVE Object Handle.

SERCX2CUSTOMRECEIVETRANSACTION-Objekthandle

Ein SERCX2CUSTOMRECEIVETRANSACTION-Objekthandgriff ist eine undurchsichtige Referenz auf ein Objekt für benutzerdefinierte Empfangs-Transaktionen in Version 2 der seriellen Framework-Erweiterung (SerCx2).

Die SerCx2CustomReceiveTransactionCreate-Methode erstellt ein objekt für die benutzerdefinierte Empfangen-Transaktion. SerCx2 verwendet dieses Objekt zum Verwalten von E/A-Transaktionen, die einen benutzerdefinierten Datenübertragungsmechanismus verwenden, um vom seriellen Controller empfangene Daten zu lesen.

Dieses Objekt ist für serielle Controllertreiber nicht transparent.

SerCx2CustomReceiveTransactionCreate stellt als Ausgabeparameter ein SERCX2CUSTOMRECEIVETRANSACTION-Handle für das neu erstellte Custom-Receive-Transaction-Objekt bereit.

SerCx2 und der serielle Controllertreiber verwenden dieses Handle, um auf das Objekt in nachfolgenden benutzerdefinierten Empfangstransaktionen zu verweisen.

Weitere Informationen finden Sie unter SerCx2 Custom-Receive Transactions.

Nachdem SerCx2CustomReceiveTransactionCreate das objekt custom-receive-transaction erstellt hat, ist dieses Objekt für die Lebensdauer des Framework-Geräteobjekts vorhanden, das das serielle Controllergerät darstellt.

Das objekt custom-receive-transaction wird automatisch gelöscht, wenn das Geräteobjekt gelöscht wird.

Der Treiber des seriellen Controllers darf nicht versuchen, das Objekt für die benutzerdefinierte Empfangstransaktion zu löschen, indem er eine Methode wie WdfObjectDelete aufruft.

Ein serieller Controllertreiber kann als Option ein objekt für eine benutzerdefinierte Empfangstransaktion erstellen, kann aber nicht mehr als ein solches Objekt erstellen.

Der Treiber kann dieses Objekt nur unter den folgenden Bedingungen erstellen:</wdcml:p>

  • Der Treiber hat zuvor ein PIO-Empfangsobjekt erstellt.
  • Der Treiber hat zuvor ein objekt für den benutzerdefinierten Empfang erstellt.

Weitere Informationen zu PIO-Empfangsobjekten finden Sie unter SERCX2PIORECEIVE Object Handle. Weitere Informationen zu benutzerdefinierten Empfangen-Objekten finden Sie unter SERCX2CUSTOMRECEIVE Object Handle.

Trotz der ähnlichen Lebensdauer von benutzerdefinierten Empfangs- und Empfangstransaktionsobjekten werden diese als separate Objekttypen (und nicht in einem Typ zusammengefasst) definiert, um eine mögliche zukünftige Erweiterung der SerCx2-Gerätetreiberschnittstelle zu unterstützen.

SERCX2CUSTOMTRANSMIT-Objekthandle

Ein SERCX2CUSTOMTRANSMIT Objekthandle ist ein undurchsichtiger Verweis auf ein benutzerdefiniertes Übertragungsobjekt in Version 2 der seriellen Frameworkerweiterung (SerCx2).

Die SerCx2CustomTransmitCreate-Methode erstellt ein custom-transmit object.h SerCx2 verwendet dieses Objekt zum Verwalten von E/A-Transaktionen, die Daten in den seriellen Controller schreiben. Dieses Objekt ist für serielle Controllertreiber nicht transparent.

SerCx2CustomTransmitCreate stellt als Ausgabeparameter ein SERCX2CUSTOMTRANSMIT Handle für das neu erstellte benutzerdefinierte Übertragungsobjekt bereit. SerCx2 und der serielle Controllertreiber verwenden dieses Handle, um in nachfolgenden Aufrufen von SerCx2-Methoden und Ereignisrückruffunktionen auf das Objekt zu verweisen.

Nachdem SerCx2CustomTransmitCreate das objekt für die benutzerdefinierte Übertragung erstellt hat, ist dieses Objekt für die Lebensdauer des Framework-Geräteobjekts vorhanden, das das serielle Controllergerät darstellt.

Das objekt für die benutzerdefinierte Übertragung wird automatisch gelöscht, wenn das Geräteobjekt gelöscht wird. Der treiber des seriellen Controllers darf nicht versuchen, das benutzerdefinierte Übertragungsobjekt durch Aufrufen einer Methode wie WdfObjectDelete zu löschen.

Ein serieller Controllertreiber kann als Option ein benutzerdefiniertes Übertragungsobjekt erstellen, jedoch nicht mehr als ein solches Objekt erstellen.

Der Treiber kann dieses Objekt nur unter den folgenden Bedingungen erstellen:

  • Der Treiber hat zuvor ein PIO-Übertragungsobjekt erstellt.
  • Der Treiber hat kein System-DMA-Übertragungsobjekt erstellt.

Weitere Informationen zu PIO-Übertragungsobjekten finden Sie unter SERCX2PIOTRANSMIT Object Handle. Weitere Informationen zu System-DMA-Transmit-Objekten finden Sie unter SERCX2SYSTEMDMATRANSMIT Object Handle.

SERCX2CUSTOMTRANSMITTRANSACTION Objekthandle

Ein SERCX2CUSTOMTRANSMITTRANSACTION-Objekthandle ist ein intransparenter Verweis auf ein benutzerdefiniertes Übertragungs-Transaktionsobjekt in Version 2 der seriellen Framework-Erweiterung (SerCx2).

Die SerCx2CustomTransmitTransactionCreate-Methode erstellt ein Custom-Transmit-Transaction-Objekt. SerCx2 verwendet dieses Objekt zum Verwalten von E/A-Transaktionen, die einen benutzerdefinierten Datenübertragungsmechanismus verwenden, um Daten in den seriellen Controller zu schreiben. Dieses Objekt ist für serielle Controllertreiber nicht transparent.

SerCx2CustomTransmitTransactionCreate stellt als Ausgabeparameter ein SERCX2CUSTOMTRANSMITTRANSACTION Handle für das neu erstellte objekt für benutzerdefinierte Übertragungstransaktion bereit. SerCx2 und der serielle Controllertreiber verwenden dieses Handle, um auf das Objekt in nachfolgenden benutzerdefinierten Übertragungstransaktionen zu verweisen.

Weitere Informationen finden Sie unter SerCx2 Custom-Transmit Transactions.

Nachdem SerCx2CustomTransmitTransactionCreate das objekt custom-transmit-transaction erstellt hat, ist dieses Objekt für die Lebensdauer des Framework-Geräteobjekts vorhanden, das das serielle Controllergerät darstellt. Das objekt "custom-transmit-transaction" wird automatisch gelöscht, wenn das Geräteobjekt gelöscht wird. Der treiber des seriellen Controllers darf nicht versuchen, das objekt custom-transmit-transaction durch Aufrufen einer Methode wie WdfObjectDelete zu löschen.

Ein serieller Controllertreiber kann als Option ein benutzerdefiniertes Übertragungsobjekt erstellen, jedoch nicht mehr als ein solches Objekt erstellen. Der Treiber kann dieses Objekt nur unter den folgenden Bedingungen erstellen:

  • Der Treiber hat zuvor ein PIO-Übertragungsobjekt erstellt.
  • Der Treiber hat kein System-DMA-Übertragungsobjekt erstellt.

Weitere Informationen zu PIO-Übertragungsobjekten finden Sie unter SERCX2PIOTRANSMIT Object Handle. Weitere Informationen zu benutzerdefinierten Übertragungsobjekten finden Sie unter SERCX2CUSTOMTRANSMIT Object Handle.

Trotz der ähnlichen Lebensdauer von benutzerdefinierten Übertragungs- und benutzerdefinierten Übertragungstransaktionsobjekten werden diese als separate Objekttypen (und nicht in einem Typ kombiniert) definiert, um die mögliche zukünftige Erweiterung der SerCx2-Gerätetreiberschnittstelle zu unterstützen.

SERCX2PIORECEIVE-Objekthandle

Ein SERCX2PIORECEIVE Objekthandle ist ein undurchsichtiger Verweis auf ein PIO-Empfangsobjekt in Version 2 der seriellen Frameworkerweiterung (SerCx2).

Die SerCx2PioReceiveCreate-Methode erstellt ein PIO-Empfangsobjekt. SerCx2 verwendet Objekt, um PIO-Transaktionen (programmierte E/A) zu verwalten, die Daten vom seriellen Controller lesen. Dieses Objekt ist für serielle Controllertreiber nicht transparent. stellt als Ausgabeparameter ein SERCX2PIORECEIVE Handle für das neu erstellte PIO-Empfangsobjekt bereit. SerCx2 und der serielle Controllertreiber verwenden dieses Handle, um auf das Objekt in nachfolgenden PIO-Empfangstransaktionen zu verweisen.

Weitere Informationen finden Sie unter SerCx2 PIO-Receive Transactions. Nachdem SerCx2PioReceiveCreate das PIO-Empfangsobjekt erstellt hat, ist dieses Objekt für die Lebensdauer des Framework-Geräteobjekts vorhanden, das das serielle Controllergerät darstellt. Das PIO-Empfangsobjekt wird automatisch gelöscht, wenn das Geräteobjekt gelöscht wird. Der Treiber des seriellen Controllers darf nicht versuchen, das PIO-Empfangen-Objekt durch Aufrufen einer Methode wie WdfObjectDelete zu löschen.

Ein serieller Controllertreiber muss ein und nur ein PIO-Empfangsobjekt erstellen. Der Treiber muss dieses Objekt erstellen, bevor ein System-DMA-Empfangsobjekt oder ein benutzerdefiniertes Empfangsobjekt erstellt wird. Weitere Informationen zu System-DMA-Empfangsobjekten finden Sie unter SERCX2SYSTEMDMARECEIVE Object Handle. Weitere Informationen zu benutzerdefinierten Empfangen-Objekten finden Sie unter SERCX2CUSTOMRECEIVE Object Handle.

SERCX2PIOTRANSMIT-Objekt-Handle

Ein SERCX2PIOTRANSMIT-Objekthandle ist ein undurchsichtiger Verweis auf ein PIO-Übertragungsobjekt in Version 2 der seriellen Framework-Erweiterung (SerCx2).

Die SerCx2PioTransmitCreate-Methode erstellt ein PIO-Übertragungsobjekt. SerCx2 verwendet dieses Objekt zum Verwalten von E/A-Transaktionen, die programmierte E/A (PIO) zum Schreiben von Daten in den seriellen Controller verwenden. Dieses Objekt ist für serielle Controllertreiber nicht transparent. SerCx2PioTransmitCreate stellt als Ausgabeparameter ein SERCX2PIOTRANSMIT Handle für das neu erstellte PIO-Übertragungsobjekt bereit. SerCx2 und der serielle Controllertreiber verwenden dieses Handle, um auf das Objekt in nachfolgenden PIO-Übertragungstransaktionen zu verweisen. Weitere Informationen finden Sie unter SerCx2 PIO-Transmit Transaktionen. Nachdem SerCx2PioTransmitCreate das PIO-Übertragungsobjekt erstellt hat, ist dieses Objekt für die Lebensdauer des Framework-Geräteobjekts vorhanden, das das serielle Controllergerät darstellt. Das PIO-Übertragungsobjekt wird automatisch gelöscht, wenn das Geräteobjekt gelöscht wird. Der serielle Controllertreiber darf nicht versuchen, das PIO-Übertragungsobjekt durch Aufrufen einer Methode wie WdfObjectDelete zu löschen.

Ein serieller Controllertreiber muss ein und nur ein PIO-Übertragungsobjekt erstellen. Der Treiber muss dieses Objekt erstellen, bevor ein System-DMA-übertragungsobjekt oder ein benutzerdefiniertes Übertragungsobjekt erstellt wird. Weitere Informationen zu System-DMA-Transmit-Objekten finden Sie unter SERCX2SYSTEMDMATRANSMIT Object Handle. Weitere Informationen zu benutzerdefinierten Übertragungsobjekten finden Sie unter SERCX2CUSTOMTRANSMIT Object Handle.

SERCX2SYSTEMDMARECEIVE-Objekthandle

Ein SERCX2SYSTEMDMARECEIVE-Objekt-Handle ist ein undurchsichtiger Verweis auf ein System-DMA-Empfangsobjekt in Version 2 der seriellen Frameworkerweiterung (SerCx2).

Die SerCx2SystemDmaReceiveCreate-Methode erstellt ein System-DMA-Receive-Objekt. SerCx2 verwendet dieses Objekt zum Verwalten von System-DMA-Transaktionen, die Daten vom seriellen Controller lesen. Dieses Objekt ist für serielle Controllertreiber nicht transparent. SerCx2SystemDmaReceiveCreate stellt als Ausgabeparameter ein SERCX2SYSTEMDMARECEIVE Handle für das neu erstellte System-DMA-Receive-Objekt bereit. SerCx2 und der serielle Controllertreiber verwenden dieses Handle, um auf das Objekt in nachfolgenden System-DMA-Empfangstransaktionen zu verweisen. Weitere Informationen finden Sie unter SerCx2 System-DMA-Receive Transactions.

Nachdem SerCx2SystemDmaReceiveCreate das System-DMA-Receive-Objekt erstellt hat, ist dieses Objekt für die Lebensdauer des Framework-Geräteobjekts vorhanden, das das serielle Controllergerät darstellt. Das System-DMA-Receive-Objekt wird automatisch gelöscht, wenn das Geräteobjekt gelöscht wird. Ein serieller Controllertreiber kann als Option ein System-DMA-Empfangsobjekt erstellen, kann aber nicht mehr als ein solches Objekt erstellen. Der Treiber kann dieses Objekt nur unter den folgenden Bedingungen erstellen:

  • Der Treiber hat zuvor ein PIO-Empfangsobjekt erstellt.
  • Der Treiber hat kein objekt für den benutzerdefinierten Empfang erstellt.

Weitere Informationen zu PIO-Empfangsobjekten finden Sie unter SERCX2PIORECEIVE Object Handle. Weitere Informationen zu benutzerdefinierten Empfangen-Objekten finden Sie unter SERCX2CUSTOMRECEIVE Object Handle.

SERCX2SYSTEMDMATRANSMIT-Objekthandle

Ein SERCX2SYSTEMDMATRANSMIT Objekthandle ist ein undurchsichtiger Verweis auf ein System-DMA-Übertragungsobjekt in Version 2 der seriellen Frameworkerweiterung (SerCx2).

Die SerCx2SystemDmaTransmitCreate-Methode erstellt ein System-DMA-Übertragungsobjekt. SerCx2 verwendet dieses Objekt zum Verwalten von System-DMA-Transaktionen, die Daten in den seriellen Controller schreiben. Dieses Objekt ist für serielle Controllertreiber nicht transparent. SerCx2SystemDmaTransmitCreate stellt als Ausgabeparameter ein SERCX2SYSTEMDMATRANSMIT Handle für das neu erstellte System-DMA-übertragungsobjekt bereit. SerCx2 und der serielle Controllertreiber verwenden dieses Handle, um auf das Objekt in nachfolgenden System-DMA-Übertragungstransaktionen zu verweisen. Weitere Informationen finden Sie unter SerCx2 System-DMA-Transmit Transactions.

Nachdem SerCx2SystemDmaTransmitCreate das System-DMA-transmit-Objekt erstellt hat, ist dieses Objekt für die Lebensdauer des Framework-Geräteobjekts vorhanden, das das serielle Controllergerät darstellt. Das System-DMA-transmit-Objekt wird automatisch gelöscht, wenn das Geräteobjekt gelöscht wird. Der serielle Controllertreiber darf nicht versuchen, das System-DMA-Übertragungsobjekt durch Aufrufen einer Methode wie WdfObjectDelete zu löschen.

Ein serieller Controllertreiber kann als Option ein System-DMA-Übertragungsobjekt erstellen, kann aber nicht mehr als ein solches Objekt erstellen. Der Treiber kann dieses Objekt nur unter den folgenden Bedingungen erstellen:</wdcml:p>

  • Der Treiber hat zuvor ein PIO-Übertragungsobjekt erstellt.
  • Der Treiber hat kein benutzerdefiniertes Übertragungsobjekt erstellt.

Weitere Informationen zu PIO-Übertragungsobjekten finden Sie unter SERCX2PIOTRANSMIT Object Handle. Weitere Informationen zu benutzerdefinierten Übertragungsobjekten finden Sie unter SERCX2CUSTOMTRANSMIT Object Handle.

SerCx2 Custom-Receive Transaktionen

SerCx2 Custom-Transmit-Transaktionen

SerCx2 PIO-Receive Transaktionen

SerCx2 PIO-Transmit Transaktionen

SerCx2 System-DMA-Receive Transaktionen

SerCx2 System-DMA-Transmit Transaktionen

SerCx2CustomReceiveTransactionCreate

SerCx2CustomTransmitCreate

SerCx2CustomTransmitTransactionCreate

SerCx2PioReceiveCreate

SerCx2PioReceiveCreate

SerCx2PioTransmitCreate

SerCx2SystemDmaReceiveCreate

SerCx2SystemDmaTransmitCreate

Zusammenfassung von Framework-Objekten

WdfObjectDelete-

  • Last updated on