Compartilhar via


DMAIssueTransfer

Windows Mobile Not SupportedWindows Embedded CE Supported

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