struttura SERCX_BUFFER_DESCRIPTOR (sercx.h)

La struttura SERCX_BUFFER_DESCRIPTOR descrive un buffer di dati per un'operazione di ricezione o trasmissione.

Sintassi

typedef struct SERCX_BUFFER_DESCRIPTOR {
  USHORT Size;
  PUCHAR Buffer;
  ULONG  Length;
} SERCX_BUFFER_DESCRIPTOR, *PSERCX_BUFFER_DESCRIPTOR;

Members

Size

Dimensione, in byte, della struttura. I metodi SerCxRetrieveReceiveBuffer e SerCxRetrieveTransmitBuffer usano questo membro per determinare la versione della struttura utilizzata dal chiamante. Le dimensioni di questa struttura potrebbero cambiare nelle versioni future del file di intestazione Sercx.h.

Buffer

Indirizzo di memoria virtuale del buffer. La memoria per il buffer non è di paging.

Length

Numero di byte disponibili nel buffer. Questa dimensione determina il numero massimo di byte che possono essere trasferiti dall'operazione di ricezione o trasmissione.

Commenti

Il driver del controller seriale usa le informazioni contenute in questa struttura per determinare da dove in memoria leggere i dati durante un'operazione di ricezione e dove in memoria scrivere i dati durante un'operazione di trasmissione.

In qualsiasi momento, non possono essere presenti più di un buffer di ricezione valido e un buffer di trasmissione valido. Il driver del controller chiama il metodo SerCxRetrieveReceiveBuffer per ottenere il buffer di ricezione e chiama il metodo SerCxRetrieveTransmitBuffer per ottenere il buffer di trasmissione. Entrambi i metodi copiano le descrizioni del buffer nelle strutture SERCX_BUFFER_DESCRIPTOR allocate dal chiamante. Una chiamata successiva a uno di questi metodi invalida rispettivamente il descrittore rilasciato in precedenza per il buffer di ricezione o il buffer di trasmissione. Il chiamante non deve accedere a un buffer descritto da un descrittore di buffer che non è più valido.

I buffer ottenuti dalle chiamate successive a SerCxRetrieveReceiveBuffer o SerCxRetrieveTransmitBuffer non sono necessariamente contigui.

Il driver del controller deve chiamare la funzione SERCX_BUFFER_DESCRIPTOR_INIT per inizializzare una struttura SERCX_BUFFER_DESCRIPTOR prima che la struttura venga passata al metodo SerCxRetrieveReceiveBuffer o SerCxRetrieveTransmitBuffer . Dopo l'inizializzazione di un descrittore di buffer, può essere riutilizzato senza essere nuovamente inizializzato.

Requisiti

Requisito	Valore
Client minimo supportato	Supportato a partire da Windows 8.
Intestazione	sercx.h

Vedi anche

SERCX_BUFFER_DESCRIPTOR_INIT

SerCxRetrieveReceiveBuffer

SerCxRetrieveTransmitBuffer