estrutura DMA_ADAPTER (wdm.h)
A estrutura DMA_ADAPTER descreve uma interface definida pelo sistema para um controlador de DMA para um determinado dispositivo. Um driver chama IoGetDmaAdapter para obter essa estrutura.
Sintaxe
typedef struct _DMA_ADAPTER {
USHORT Version;
USHORT Size;
PDMA_OPERATIONS DmaOperations;
} *PADAPTER_OBJECT, DMA_ADAPTER, *PDMA_ADAPTER;
Membros
Version
Especifica a versão dessa estrutura. A versão 3 da estrutura de DMA_ADAPTER está disponível a partir do Windows 8. Para as versões 1 e 2 dessa estrutura, esse membro é definido como o valor 1. Para obter mais informações, consulte a seção Comentários a seguir.
Size
Especifica o tamanho, em bytes, dessa estrutura.
DmaOperations
Ponteiro para uma estrutura DMA_OPERATIONS que contém ponteiros para funções do adaptador DMA. A versão da estrutura DMA_OPERATIONS para a qual esse membro aponta é determinada pela versão da estrutura DMA_ADAPTER . Assim, para a versão 1 da estrutura DMA_ADAPTER , dmaOperations aponta para a versão 1 da estrutura DMA_OPERATIONS e assim por diante. Para obter mais informações sobre versões de estrutura, consulte a seção Comentários a seguir.
Comentários
Os drivers para dispositivos que usam o DMA para transferir dados usam essa estrutura para obter os endereços das funções que permitem o uso de um controlador DMA. Normalmente, os drivers obtêm essa estrutura chamando a rotina IoGetDmaAdapter . Os drivers também podem obter essa estrutura consultando a interface BUS_INTERFACE_STANDARD .
Quando a rotina IoGetDmaAdapter retorna um ponteiro para a versão 1 ou versão 2 da estrutura DMA_ADAPTER , essa rotina sempre define o membro Version dessa estrutura como 1. Portanto, o chamador não pode usar o membro Version para distinguir entre as versões 1 e 2 da estrutura DMA_ADAPTER . Para obter mais informações sobre como determinar a versão de uma estrutura de DMA_ADAPTER retornada por essa rotina, consulte IoGetDmaAdapter.
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |