Função SerCxRetrieveTransmitBuffer (sercx.h)
O método SerCxRetrieveTransmitBuffer obtém um buffer de saída que contém dados que estão 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 de 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é Bytes de comprimento de dados disponíveis. (Os dados disponíveis no buffer podem ser menores que bytes de comprimento .) SerCxRetrieveTransmitBuffer grava o número real de bytes de dados disponíveis 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 transmissão. 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
SerCxRetrieveTransmitBuffer 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 transmissão. |
|
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 que contém os dados de saída para a operação de transmissão (gravação) 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