Função SerCxRetrieveTransmitBuffer (sercx.h)

Artigo
12/13/2024

O método SerCxRetrieveTransmitBuffer obtém um buffer de saída que contém dados prontos para serem transmitidos para a porta serial.

Sintaxe

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

Parâmetros

[in] Device

Um identificador WDFDEVICE para o objeto de dispositivo da estrutura que representa o controlador serial.

[in] Length

O comprimento do buffer solicitado, em bytes. Se a chamada SerCxRetrieveTransmitBuffer for bem-sucedida, o chamador receberá um buffer de saída que contém até comprimento bytes de dados disponíveis. (Os dados disponíveis no buffer podem ser menores que Comprimento bytes.) SerCxRetrieveTransmitBuffer grava o número real de bytes de dados disponíveis no membro de Comprimento da estrutura apontado pelo parâmetro bufferDescriptor .

[in, out] BufferDescriptor

Um ponteiro para uma estrutura de SERCX_BUFFER_DESCRIPTOR alocada pelo chamador. Essa estrutura descreve o buffer de dados a ser usado para a operação de transmissão. O chamador chamou anteriormente a função SERCX_BUFFER_DESCRIPTOR_INIT para inicializar essa estrutura. serCxRetrieveTransmitBuffer grava nos membros buffer e length membros dessa estrutura.

Valor de retorno

SerCxRetrieveTransmitBuffer retornará STATUS_SUCCESS se for bem-sucedido. Os valores de retorno de erro possíveis incluem os seguintes códigos de status.

Código de retorno	Descrição
STATUS_INVALID_DEVICE_REQUEST	O método foi chamado no IRQL errado; ou o identificador WDFDEVICE não é válido; ou dispositivo ou BufferDescriptor é NULL; ou o driver já tem um buffer de transmissão.
STATUS_INFO_LENGTH_MISMATCH	O tamanho incorreto é especificado para a estrutura de SERCX_BUFFER_DESCRIPTOR.
STATUS_INSUFFICIENT_RESOURCES	Não foi possível alocar recursos do sistema (normalmente memória).

Observações

O driver do controlador serial chama esse método para adquirir um buffer que contém os dados de saída da operação de transmissão (gravação) atual.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível a partir do Windows 8.
da Plataforma de Destino	Universal
cabeçalho	sercx.h
IRQL	<= DISPATCH_LEVEL

Consulte também

SERCX_BUFFER_DESCRIPTOR

SERCX_BUFFER_DESCRIPTOR_INIT

Compartilhar via