SerCx2-Objekthandles

Artikel
03/18/2023

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 über Funktionen und Funktionen verfügen, 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 Frameworkhandletypen finden Sie unter Zusammenfassung der Frameworkobjekte.

In diesem Thema werden die folgenden Objekthandles beschrieben:

SERCX2CUSTOMRECEIVE-Objekthandle
OBJEKTHANDLE SERCX2CUSTOMRECEIVETRANSACTION
SERCX2CUSTOMTRANSMIT-Objekthandle
SERCX2CUSTOMTRANSMITTRANSACTION-Objekthandle
SERCX2PIORECEIVE-Objekthandle
SERCX2PIOTRANSMIT-Objekthandle
SERCX2SYSTEMDMARECEIVE-Objekthandle
SERCX2SYSTEMDMATRANSMIT-Objekthandle

Header: 2.0\Sercx.h

SERCX2CUSTOMRECEIVE-Objekthandle

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

Die SerCx2CustomReceiveCreate-Methode erstellt ein benutzerdefiniertes Empfangsobjekt. SerCx2 verwendet dieses Objekt zum Verwalten von E/A-Transaktionen, die einen benutzerdefinierten Datenübertragungsmechanismus zum Lesen von Daten vom seriellen Controller verwenden. 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 custom-receive erstellt hat, ist dieses Objekt für die Lebensdauer des Frameworkgeräteobjekts vorhanden, das das serielle Controllergerät darstellt. Das benutzerdefinierte Empfangsobjekt wird automatisch gelöscht, wenn das Geräteobjekt gelöscht wird. Der Treiber des seriellen Controllers darf nicht versuchen, das objekt custom-receive durch Aufrufen einer Methode wie WdfObjectDelete zu löschen.

Ein serieller Controllertreiber kann optional ein benutzerdefiniertes Empfangsobjekt 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-receive-Objekt erstellt.
Der Treiber hat kein system-DMA-receive-Objekt erstellt.

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

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

OBJEKTHANDLE SERCX2CUSTOMRECEIVETRANSACTION

Ein SERCX2CUSTOMRECEIVETRANSACTION-Objekthandle ist ein undurchsichtiger Verweis auf ein objekt vom Typ custom-receive-transaction in Version 2 der seriellen Frameworkerweiterung (SerCx2).

Die SerCx2CustomReceiveTransactionCreate-Methode erstellt ein custom-receive-transaction-Objekt. SerCx2 verwendet dieses Objekt zum Verwalten von E/A-Transaktionen, die einen benutzerdefinierten Datenübertragungsmechanismus zum Lesen der vom seriellen Controller empfangenen Daten verwenden.

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 in nachfolgenden benutzerdefinierten Empfangstransaktionen auf das Objekt 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 serielle Controllertreiber darf nicht versuchen, das objekt custom-receive-transaction durch Aufrufen einer Methode wie WdfObjectDelete zu löschen.

Ein serieller Controllertreiber kann optional ein benutzerdefiniertes Empfangstransaktionsobjekt erstellen, 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-receive-Objekt erstellt.
Der Treiber hat zuvor ein benutzerdefiniertes Empfangsobjekt erstellt.

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

Trotz der ähnlichen Lebensdauern von Objekten vom Typ custom-receive und custom-receive-transaction werden diese als separate Objekttypen definiert (und nicht in einem Typ kombiniert), um die 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 benutzerdefiniertes Übertragungsobjekt.h SerCx2 verwendet dieses Objekt, um E/A-Transaktionen zu verwalten, 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 benutzerdefinierte Übertragungsobjekt erstellt hat, ist dieses Objekt für die Lebensdauer des Frameworkgeräteobjekts vorhanden, das das serielle Controllergerät darstellt.

Das benutzerdefinierte Übertragungsobjekt wird automatisch gelöscht, wenn das Geräteobjekt gelöscht wird. Der Treiber des seriellen Controllers darf nicht versuchen, das objekt custom-transmit durch Aufrufen einer Methode wie WdfObjectDelete zu löschen.

Ein serieller Controllertreiber kann optional ein benutzerdefiniertes Übertragungsobjekt 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-Übertragungsobjekt erstellt.
Der Treiber hat kein DMA-Übertragungsobjekt erstellt.

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

SERCX2CUSTOMTRANSMITTRANSACTION-Objekthandle

Ein OBJEKThandle SERCX2CUSTOMTRANSMITTRANSACTION ist ein undurchsichtiger Verweis auf ein objekt vom Typ custom-transmit-transaction in Version 2 der seriellen Frameworkerweiterung (SerCx2).

Die SerCx2CustomTransmitTransactionCreate-Methode erstellt ein objekt vom Typ custom-transmit-transaction. SerCx2 verwendet dieses Objekt zum Verwalten von E/A-Transaktionen, die einen benutzerdefinierten Datenübertragungsmechanismus zum Schreiben von Daten in den seriellen Controller verwenden. Dieses Objekt ist für serielle Controllertreiber nicht transparent.

SerCx2CustomTransmitTransactionCreate stellt als Ausgabeparameter ein SERCX2CUSTOMTRANSMITTRANSACTION-Handle für das neu erstellte custom-transmit-transaction-Objekt bereit. SerCx2 und der serielle Controllertreiber verwenden dieses Handle, um in nachfolgenden transaktionen mit benutzerdefinierter Übertragung auf das -Objekt 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 serielle Controllertreiber darf nicht versuchen, das objekt custom-transmit-transaction durch Aufrufen einer Methode wie WdfObjectDelete zu löschen.

Ein serieller Controllertreiber kann optional ein benutzerdefiniertes Übertragungsobjekt 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-Übertragungsobjekt erstellt.
Der Treiber hat kein 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 Lebensdauern benutzerdefinierter Übertragungs- und benutzerdefinierter Übertragungstransaktionsobjekte werden diese als separate Objekttypen definiert (und nicht in einem Typ kombiniert), 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-Receive-Objekt in Version 2 der seriellen Frameworkerweiterung (SerCx2).

Die SerCx2PioReceiveCreate-Methode erstellt ein PIO-receive-Objekt. SerCx2 verwendet das -Objekt zum Verwalten programmierter E/A-Transaktionen (PIO), 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-receive-Objekt bereit. SerCx2 und der serielle Controllertreiber verwenden dieses Handle, um in nachfolgenden PIO-Empfangstransaktionen auf das Objekt zu verweisen.

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

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

SERCX2PIOTRANSMIT-Objekthandle

Ein SERCX2PIOTRANSMIT-Objekthandle ist ein undurchsichtiger Verweis auf ein PIO-Übertragungsobjekt in Version 2 der seriellen Frameworkerweiterung (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 in nachfolgenden PIO-Übertragungstransaktionen auf das Objekt zu verweisen. Weitere Informationen finden Sie unter SerCx2 PIO-Transmit Transactions. Nachdem SerCx2PioTransmitCreate das PIO-transmit-Objekt erstellt hat, ist dieses Objekt für die Lebensdauer des Frameworkgeräteobjekts vorhanden, das das serielle Controllergerät darstellt. Das PIO-Übertragungsobjekt wird automatisch gelöscht, wenn das Geräteobjekt gelöscht wird. Der Treiber des seriellen Controllers darf nicht versuchen, das PIO-übertragungsobjekt durch Aufrufen einer Methode wie WdfObjectDelete zu löschen.

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

SERCX2SYSTEMDMARECEIVE-Objekthandle

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

Die SerCx2SystemDmaReceiveCreate-Methode erstellt ein system-DMA-receive-Objekt. SerCx2 verwendet dieses Objekt zum Verwalten von DMA-Systemtransaktionen, 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 in nachfolgenden System-DMA-Empfangstransaktionen auf das -Objekt 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 optional ein System-DMA-Receive-Objekt 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-receive-Objekt erstellt.
Der Treiber hat kein benutzerdefiniertes Empfangsobjekt erstellt.

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-transmit-Objekt. SerCx2 verwendet dieses Objekt zum Verwalten von DMA-Systemtransaktionen, 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-transmit-Objekt bereit. SerCx2 und der serielle Controllertreiber verwenden dieses Handle, um in nachfolgenden System-DMA-Übertragungstransaktionen auf das Objekt 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-transmit-Objekt durch Aufrufen einer Methode wie WdfObjectDelete zu löschen.

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