DMAIssueTransfer
9/8/2008
Essa função configura registradores descritor mapa (n.); mapear (v.) para um canalizar a mapa (n.); mapear (v.) um acesso direto à memória (DMA) transferir suspensa reserva uma bloqueada. Se houver outros acesso direto à memória (DMA) transfere enfileirado no canalizar acesso direto à memória (DMA) Esta transferir é enfileirado as well.
Syntax
BOOL DMAIssueTransfer(
HANDLE hDmaChannel,
PDMA_TRANSFER_HANDLE phDmaHandle,
DWORD dwFlags,
PHYSICAL_ADDRESS SysytemMemoryPhysicalAddress,
PVOID CurrentVa,
ULONG Length,
HANDLE hNotifyHandle,
PVOID Context1,
PVOID Context2,
PHYSICAL_ADDRESS phOpDeviceIoAddress
);
Parameters
- hDmaChannel
[no] Identificador para um canal acesso direto à memória (DMA) alocado
- phDmaHandle
[in, Out] Quando DMAIssueTransfer Retorna TRUE, para o sucesso, termo é um ponteiro para um DMA_TRANSFER_HANDLE.
dwFlags
[no] Sinalizador global transferir acesso direto à memória (DMA). Este sinalizador é usado para determinar que tipo de transferir o dispositivo quer.A seguinte tabela mostra os sinalizadores possíveis.
Valor Descrição DMA_FLAGS_WRITE_TO_DEVICE
Definir para operação de gravação.
DMA_FLAGS_INC_DEVICE_ADDRESS
Indica que a operação requer o incremento de origem e endereço de destino. Este sinalizador pode ser utilizada para realizar as transferências de memória para memória acesso direto à memória (DMA).
DMA_FLAGS_RESET_DEVICE_ADDRESS
Redefine endereço dispositivo para o original valor usado pelo DMAAllocateChannel. O endereço dispositivo pode ser alterado quando um transferir acesso direto à memória (DMA) com o sinalizador que executa DMA_FLAGS_INC_DEVICE_ADDRESS.
DMA_FLAGS_USER_OPTIONAL_DEVICE
Define a transferir acesso direto à memória (DMA) para recarregar automaticamente até que seja explicitamente cancelada.
DMA_FLAGS_NOT_AUTO_START
Indica a transferir é enfileirado para hardware até um chamar para DMAStartTransfer.
- SystemMemoryPhysicalAddress
[no] Endereço System Physical Buffer comuns. Esse endereço será obtido do HalAllocateCommonBuffer.
- CurrentVa
[no] Endereço virtual para SystemMemoryPhysicalAddress. Este valor será obtido na HalAllocateCommonBuffer.
- Comprimento
[no] Especifica o comprimento, em bytes, a ser transferido. Este valor deve ser menor ou igual a o MaximunSizeOfEachTransfer valor contido a estrutura CE_DMA_ADAPTER. Esse valor é retornado por DMAGetAdapter. Se o valor não é menor ou igual a a MaximunSizeOfEachTransfer, em seguida, a falha transferir.
- hNotifyHandle
[no] Identificador de evento usado quando é SetEvent chamado após a conclusão de transferir acesso direto à memória (DMA). Se esse identificador é NULL, em seguida, não chamar para SetEvent é feita quando a transferir for concluído.
- Context1
[no] Context1 permite que um usuário ao anexar de conteúdo para transferir a acesso direto à memória (DMA). O de conteúdo é recuperado usando um válido e DMAGetContexts acesso direto à memória (DMA) identificador.
- Context2
[no] Context2 permite que um usuário ao anexar de conteúdo para transferir a acesso direto à memória (DMA). O de conteúdo é recuperado usando um válido e DMAGetContexts acesso direto à memória (DMA) identificador.
- phOpDeviceIoAddress
[no] Endereço de E/s do dispositivo opcional para transferir este acesso direto à memória (DMA). Este parâmetro só é usado quando DMA_FLAGS_USER_OPTIONAL_DEVICE_ADDRESS for definida. O phDeviceIoAddress, fornecido pelo DMAAllocateChannel, é ignorada quando DMA_FLAGS_USER_OPTIONAL_DEVICE_ADDRESS está definido.
Return Value
Retorna TRUE em caso de sucesso. O associado acesso direto à memória (DMA) identificador para o DMA Transfer é retornado através de phDmaHandle.
Remarks
DMAIssueTransfer Permite que hardware acesso direto à memória (DMA) para iniciar este driver quando o DMA Channel está livre. Quando não é um canal acesso direto à memória (DMA) livre, o acesso direto à memória (DMA) é transferir enfileirado até as DMA Channel livre novamente.
Requirements
Header | oaldma.h |
Library | CEDDK.lib |
Windows Embedded CE | Windows Embedded CE 6.0 and later |
See Also
Reference
CEDDK Dynamic-Link Library DMA Functions
CEDDK Dynamic-Link Library DMA Structures