Funzione SerCxRetrieveReceiveBuffer (sercx.h)

Articolo
02/26/2024

Il metodo SerCxRetrieveReceiveBuffer ottiene un buffer di input in cui i dati ricevuti dalla porta seriale possono essere caricati.

Sintassi

NTSTATUS SerCxRetrieveReceiveBuffer(
  [in]      WDFDEVICE                Device,
  [in]      ULONG                    Length,
  [in, out] PSERCX_BUFFER_DESCRIPTOR BufferDescriptor
);

Parametri

[in] Device

Handle WDFDEVICE per l'oggetto dispositivo framework che rappresenta il controller seriale.

[in] Length

Lunghezza del buffer richiesta, in byte. Se la chiamata SerCxRetrieveReceiveBuffer ha esito positivo, il chiamante riceve un buffer di input contenente fino a lunghezza di byte di spazio disponibile. Lo spazio disponibile nel buffer potrebbe essere minore di byte di lunghezza . SerCxRetrieveReceiveBuffer scrive il numero effettivo di byte di spazio disponibile nel membro Length della struttura a cui punta il parametro BufferDescriptor .

[in, out] BufferDescriptor

Puntatore a una struttura SERCX_BUFFER_DESCRIPTOR allocata dal chiamante. Questa struttura descrive il buffer dei dati da usare per l'operazione di ricezione. Il chiamante ha precedentemente chiamato la funzione SERCX_BUFFER_DESCRIPTOR_INIT per inizializzare questa struttura. SerCxRetrieveTransmitBuffer scrive nei membri Buffer e Length di questa struttura.

Valore restituito

SerCxRetrieveReceiveBuffer restituisce STATUS_SUCCESS se ha esito positivo. I valori restituiti degli errori possibili includono i codici di stato seguenti.

Codice restituito	Descrizione
STATUS_INVALID_DEVICE_REQUEST	Il metodo è stato chiamato al irQL errato; o l'handle WDFDEVICE non è valido; o dispositivo o bufferDescriptor è NULL; o il driver ha già un buffer di ricezione.
STATUS_INFO_LENGTH_MISMATCH	La dimensione errata viene specificata per la struttura SERCX_BUFFER_DESCRIPTOR .
STATUS_INSUFFICIENT_RESOURCES	Impossibile allocare le risorse di sistema (in genere memoria).

Commenti

Il driver del controller seriale chiama questo metodo per acquisire un buffer per contenere dati di input dall'operazione di ricezione corrente (lettura).

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile a partire da Windows 8.
Piattaforma di destinazione	Universale
Intestazione	sercx.h
IRQL	<= DISPATCH_LEVEL

Vedi anche

SERCX_BUFFER_DESCRIPTOR

SERCX_BUFFER_DESCRIPTOR_INIT

Condividi tramite