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;

Membri

Size

Dimensione, in byte, di questa struttura. I metodi SerCxRetrieveReceiveBu ffer e SerCxRetrieveTransmitBuffer utilizzano 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.

Osservazioni

Il driver del controller seriale usa le informazioni contenute in questa struttura per determinare la posizione in memoria da cui 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ù buffer di ricezione validi 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 di 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 non più valido.

I buffer ottenuti da 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 inizializzato di nuovo.

Fabbisogno

Requisito	Valore
client minimo supportato	Supportato a partire da Windows 8.
intestazione	sercx.h

Vedere anche

SERCX_BUFFER_DESCRIPTOR_INIT

SerCxRetrieveReceiveBuffer

SerCxRetrieveTransmitBuffer