Funzione SerCxRetrieveTransmitBuffer (sercx.h)

  • Articolo

Il metodo SerCxRetrieveTransmitBuffer ottiene un buffer di output che contiene dati pronti per la trasmissione alla porta seriale.

Sintassi

NTSTATUS SerCxRetrieveTransmitBuffer(
  [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 SerCxRetrieveTransmitBuffer ha esito positivo, il chiamante riceve un buffer di output contenente fino a lunghezza di byte di dati disponibili. I dati disponibili nel buffer potrebbero essere inferiori alla lunghezza dei byte. SerCxRetrieveTransmitBuffer scrive il numero effettivo di byte di dati disponibili 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 trasmissione. Il chiamante in precedenza ha chiamato la funzione SERCX_BUFFER_DESCRIPTOR_INIT per inizializzare questa struttura. SerCxRetrieveTransmitBuffer scrive nei membri Buffer e Length di questa struttura.

Valore restituito

SerCxRetrieveTransmitBuffer 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 Device o BufferDescriptor è NULL; o il driver ha già un buffer di trasmissione.
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).

Commenti

Il driver del controller seriale chiama questo metodo per acquisire un buffer contenente i dati di output per l'operazione di trasmissione corrente (scrittura).

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