Compartir a través de

PGET_DMA_ADAPTER_INFO función de devolución de llamada (wdm.h)

  • Artículo

La rutina GetDmaAdapterInfo recupera información sobre las funcionalidades de hardware de un canal DMA del sistema.

Sintaxis

PGET_DMA_ADAPTER_INFO PgetDmaAdapterInfo;

NTSTATUS PgetDmaAdapterInfo(
  [in]      PDMA_ADAPTER DmaAdapter,
  [in, out] PDMA_ADAPTER_INFO AdapterInfo
)
{...}

Parámetros

[in] DmaAdapter

Puntero a una estructura de DMA_ADAPTER . Esta estructura es el objeto de adaptador que representa el canal DMA del sistema del controlador. El autor de la llamada obtuvo este puntero de una llamada anterior a la rutina IoGetDmaAdapter .

[in, out] AdapterInfo

Puntero a una estructura de DMA_ADAPTER_INFO asignada por el autor de la llamada. La rutina escribe información sobre el controlador DMA del sistema en esta estructura. El llamador debe establecer el miembro Version de esta estructura en DMA_ADAPTER_INFO_VERSION1 antes de llamar a GetDmaAdapterInfo.

Valor devuelto

GetDmaAdapterInfo devuelve STATUS_SUCCESS si la llamada se realiza correctamente. Los valores devueltos de error posibles incluyen el siguiente código de estado.

Código devuelto Descripción
STATUS_NOT_SUPPORTED
 La rutina no admite la versión especificada de la estructura DMA_ADAPTER_INFO_XXX .

Comentarios

GetDmaAdapterInfo no es una rutina del sistema a la que se puede llamar directamente por su nombre. Solo el puntero de la dirección devuelta en una estructura de DMA_OPERATIONS puede llamar a esta rutina . Los controladores obtienen la dirección de esta rutina llamando a IoGetDmaAdapter con el miembro Version del parámetro DeviceDescription establecido en DEVICE_DESCRIPTION_VERSION3. Si IoGetDmaAdapter devuelve NULL, la rutina no está disponible en la plataforma.

GetDmaAdapterInfo recupera la siguiente información:

  • El número máximo de elementos de una lista de dispersión y recopilación que el controlador DMA puede procesar en una sola operación de dispersión o recopilación de DMA.
  • Ancho, en bits, de una dirección DMA.
Para obtener información sobre la información del adaptador DMA que proporciona la versión 1 de la estructura DMA_ADAPTER_INFO_XXX , consulte DMA_ADAPTER_INFO_V1.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible a partir de Windows 8.
Plataforma de destino Escritorio
Encabezado wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h)
IRQL <= DISPATCH_LEVEL

Consulte también

DMA_ADAPTER

DMA_ADAPTER_INFO

DMA_OPERATIONS

IoGetDmaAdapter