Método IDmaChannelSlave::Start (portcls.h)
O método Start inicia um objeto DMA subordinado.
Sintaxe
NTSTATUS Start(
ULONG MapSize,
BOOLEAN WriteToDevice
);
Parâmetros
MapSize
Especifica o número de bytes do buffer alocado que devem ser mapeados. O tamanho do mapa não deve exceder o tamanho do buffer alocado na chamada para IDmaChannel::AllocateBuffer.
WriteToDevice
Especifica a direção da movimentação de dados. Se TRUE, os dados serão movidos do buffer para o dispositivo. Se FALSE, os dados serão movidos do dispositivo para o buffer.
Retornar valor
Esse método retorna NTSTATUS. Ele retornará STATUS_SUCCESS se a chamada tiver sido bem-sucedida. Caso contrário, o método retorna um código de erro apropriado. Se o chamador tentar iniciar um canal que já foi iniciado, o método retornará imediatamente com o código de erro STATUS_UNSUCCESSFUL.
Comentários
Observação
A Microsoft dá suporte a um ambiente diversificado e inclusivo. Este artigo contém referências à terminologia que o guia de estilo da Microsoft para comunicação sem preconceitos reconhece como excludente. A palavra ou frase é usada neste artigo para consistência porque ela aparece atualmente no software. Quando o software for atualizado para remover o idioma, este artigo será atualizado para estar em alinhamento.
O método primeiro configura registros de mapa para mapear os primeiros bytes mapSize do buffer alocado para o objeto do adaptador. Em seguida, o método inicia uma transferência de DMA do número de bytes especificado em MapSize.
Para obter mais informações sobre esse método, consulte IDmaChannel::BufferSize e IDmaChannelSlave::ReadCounter.
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | portcls.h |
| IRQL | PASSIVE_LEVEL |