SERCX_BUFFER_DESCRIPTOR Struktur (sercx.h)
Die SERCX_BUFFER_DESCRIPTOR-Struktur beschreibt einen Datenpuffer für einen Empfangsvorgang oder Übertragungsvorgang.
Syntax
typedef struct SERCX_BUFFER_DESCRIPTOR {
USHORT Size;
PUCHAR Buffer;
ULONG Length;
} SERCX_BUFFER_DESCRIPTOR, *PSERCX_BUFFER_DESCRIPTOR;
Angehörige
Size
Die Größe dieser Struktur in Byte. Die SerCxRetrieveReceiveBuffer und SerCxRetrieveTransmitBuffer Methoden verwenden dieses Element, um zu bestimmen, welche Version der Struktur der Aufrufer verwendet. Die Größe dieser Struktur kann sich in zukünftigen Versionen der Headerdatei Sercx.h ändern.
Buffer
Die virtuelle Speicheradresse des Puffers. Der Speicher für den Puffer ist nicht ausgelagert.
Length
Die Anzahl der im Puffer verfügbaren Bytes. Diese Größe bestimmt die maximale Anzahl von Bytes, die vom Empfangs- oder Übertragungsvorgang übertragen werden können.
Bemerkungen
Der treiber des seriellen Controllers verwendet die Informationen in dieser Struktur, um zu bestimmen, aus welchem Speicher Daten während eines Empfangsvorgangs gelesen werden sollen und wo im Arbeitsspeicher Daten während eines Übertragungsvorgangs geschrieben werden sollen.
Es kann jederzeit maximal ein gültiger Empfangspuffer und ein gültiger Übertragungspuffer vorhanden sein. Der Controllertreiber ruft die SerCxRetrieveReceiveBuffer Methode auf, um den Empfangspuffer abzurufen, und ruft die SerCxRetrieveTransmitBuffer Methode zum Abrufen des Übertragungspuffers auf. Beide Methoden kopieren Pufferbeschreibungen in aufrufergeteilte SERCX_BUFFER_DESCRIPTOR Strukturen. Bei einem nachfolgenden Aufruf einer dieser Methoden wird der zuvor ausgestellte Deskriptor für den Empfangspuffer bzw. sendepuffer ungültig. Der Aufrufer darf nicht auf einen Puffer zugreifen, der von einem nicht mehr gültigen Pufferdeskriptor beschrieben wird.
Die Puffer, die durch aufeinander folgende Aufrufe von SerCxRetrieveReceiveBuffer oder SerCxRetrieveTransmitBuffer abgerufen werden, sind nicht garantiert zusammenhängend.
Der Controllertreiber muss die SERCX_BUFFER_DESCRIPTOR_INIT-Funktion aufrufen, um eine SERCX_BUFFER_DESCRIPTOR Struktur zu initialisieren, bevor die Struktur an die SerCxRetrieveReceiveBuffer oder SerCxRetrieveTransmitBuffer Methode übergeben wird. Nachdem ein Pufferdeskriptor initialisiert wurde, kann er wiederverwendet werden, ohne erneut initialisiert zu werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Wird ab Windows 8 unterstützt. |
| Header- | sercx.h |