Funzione SerCxRetrieveReceiveBuffer (sercx.h)

Articolo
12/13/2024

Il metodo SerCxRetrieveReceiveBuffer ottiene un buffer di input in cui è possibile caricare i dati ricevuti dalla porta seriale.

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, espressa in byte. Se il SerCxRetrieveReceiveBuffer chiamata ha esito positivo, il chiamante riceve un buffer di input contenente fino a lunghezza byte di spazio disponibile. Lo spazio disponibile nel buffer potrebbe essere minore di lunghezza byte. 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 di dati da utilizzare 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 di errore possibili includono i codici di stato seguenti.

Codice restituito	Descrizione
STATUS_INVALID_DEVICE_REQUEST	Il metodo è stato chiamato in 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 risorse di sistema (in genere memoria).

Osservazioni

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

Fabbisogno

Requisito	Valore
client minimo supportato	Disponibile a partire da Windows 8.
piattaforma di destinazione	Universale
intestazione	sercx.h
IRQL	<= DISPATCH_LEVEL

Vedere anche

SERCX_BUFFER_DESCRIPTOR

SERCX_BUFFER_DESCRIPTOR_INIT

Condividi tramite