PGET_DMA_ADAPTER_INFO función de devolución de llamada (wdm.h)
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 autor de la llamada debe establecer el miembro Version de 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. Entre los posibles valores devueltos de error se incluyen el siguiente código de estado.
| Código devuelto | Descripción |
|---|---|
|
La rutina no admite la versión especificada de la estructura deXXX de DMA_ADAPTER_INFO_. |
Observaciones
GetDmaAdapterInfo no es una rutina del sistema a la que se puede llamar directamente por nombre. Solo se puede llamar a esta rutina por puntero desde la dirección devuelta en una estructura de DMA_OPERATIONS. 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:
- Número máximo de elementos de una lista de dispersión o 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.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible a partir de Windows 8. |
| de la plataforma de destino de | Escritorio |
| encabezado de | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| irQL | <= DISPATCH_LEVEL |