estructura DMA_ADAPTER (wdm.h)

  • Artículo

La estructura DMA_ADAPTER describe una interfaz definida por el sistema en un controlador DMA para un dispositivo determinado. Un controlador llama a IoGetDmaAdapter para obtener esta estructura.

Sintaxis

typedef struct _DMA_ADAPTER {
  USHORT          Version;
  USHORT          Size;
  PDMA_OPERATIONS DmaOperations;
} *PADAPTER_OBJECT, DMA_ADAPTER, *PDMA_ADAPTER;

Miembros

Version

Especifica la versión de esta estructura. La versión 3 de la estructura de DMA_ADAPTER está disponible a partir de Windows 8. Para las versiones 1 y 2 de esta estructura, este miembro se establece en el valor 1. Para obtener más información, vea la sección Comentarios que se muestra más adelante.

Size

Especifica el tamaño, en bytes, de esta estructura.

DmaOperations

Puntero a una estructura de DMA_OPERATIONS que contiene punteros a las funciones del adaptador DMA. La versión de la estructura DMA_OPERATIONS a la que apunta este miembro viene determinada por la versión de la estructura de DMA_ADAPTER . Por lo tanto, para la versión 1 de la estructura de DMA_ADAPTER , DmaOperations apunta a la versión 1 de la estructura de DMA_OPERATIONS , etc. Para obtener más información sobre las versiones de estructura, vea la siguiente sección Comentarios.

Comentarios

Los controladores de los dispositivos que usan DMA para transferir datos usan esta estructura para obtener las direcciones de las funciones que permiten el uso de un controlador DMA. Normalmente, los controladores obtienen esta estructura llamando a la rutina IoGetDmaAdapter . Los controladores también pueden obtener esta estructura consultando la interfaz BUS_INTERFACE_STANDARD .

Cuando la rutina IoGetDmaAdapter devuelve un puntero a la versión 1 o la versión 2 de la estructura de DMA_ADAPTER , esta rutina siempre establece el miembro Version de esta estructura en 1. Por lo tanto, el autor de la llamada no puede usar el miembro Version para distinguir entre las versiones 1 y 2 de la estructura DMA_ADAPTER . Para obtener más información sobre cómo determinar la versión de una estructura de DMA_ADAPTER devuelta por esta rutina, consulte IoGetDmaAdapter.

Requisitos

Requisito Valor
Header wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h)

Consulte también

BUS_INTERFACE_STANDARD

DMA_OPERATIONS

IoGetDmaAdapter