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 |
---|---|
|
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. |
|
O tamanho errado é especificado para a estrutura SERCX_BUFFER_DESCRIPTOR . |
|
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
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de