Compartilhar via


Função SerCxRetrieveReceiveBuffer (sercx.h)

O método SerCxRetrieveReceiveBuffer obtém um buffer de entrada no qual os dados recebidos da porta serial podem ser carregados.

Sintaxe

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

Parâmetros

[in] Device

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

[in] Length

O comprimento do buffer solicitado, em bytes. Se a chamada SerCxRetrieveReceiveBuffer for bem-sucedida, o chamador receberá um buffer de entrada que contém até Bytes de comprimento de espaço disponível. (O espaço disponível no buffer pode ser menor que bytes de comprimento .) SerCxRetrieveReceiveBuffer grava o número real de bytes de espaço disponível no membro Length da estrutura apontada 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 recebimento. O chamador anteriormente chamou a função SERCX_BUFFER_DESCRIPTOR_INIT para inicializar essa estrutura. SerCxRetrieveTransmitBuffer grava nos membrosBuffer e Comprimento dessa estrutura.

Retornar valor

SerCxRetrieveReceiveBuffer retornará STATUS_SUCCESS se for bem-sucedido. Os possíveis valores retornados por erro 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 Device ou BufferDescriptor é NULL; ou o driver já tem um buffer de recebimento.
STATUS_INFO_LENGTH_MISMATCH
O tamanho errado é especificado para a estrutura SERCX_BUFFER_DESCRIPTOR .
STATUS_INSUFFICIENT_RESOURCES
Não foi possível alocar recursos do sistema (normalmente memória).

Comentários

O driver do controlador serial chama esse método para adquirir um buffer para conter dados de entrada da operação de recebimento (leitura) atual.

Requisitos

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

Confira também

SERCX_BUFFER_DESCRIPTOR

SERCX_BUFFER_DESCRIPTOR_INIT