PCONFIGURE_ADAPTER_CHANNEL función de devolución de llamada (wdm.h)
La rutina ConfigureAdapterChannel invoca una función personalizada implementada por el controlador DMA representada por un objeto de adaptador.
Sintaxis
PCONFIGURE_ADAPTER_CHANNEL PconfigureAdapterChannel;
NTSTATUS PconfigureAdapterChannel(
[in] PDMA_ADAPTER DmaAdapter,
[in] ULONG FunctionNumber,
[in] PVOID Context
)
{...}
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] FunctionNumber
Número de la función personalizada que se va a seleccionar. Para obtener más información, vea la sección Comentarios.
[in] Context
Puntero a los parámetros de configuración de la función personalizada especificada por FunctionNumber. El controlador DMA implementa la función y un controlador de dispositivo puede acceder a ella a través del objeto adaptador. El controlador DMA y el controlador del dispositivo deben aceptar el significado de estos parámetros de configuración. Los datos a los que context apunta son opacos para el sistema operativo.
Valor devuelto
ConfigureAdapterChannel devuelve STATUS_SUCCESS si la llamada se realiza correctamente. Entre los posibles valores devueltos de error se incluyen el siguiente código de estado.
| Valor devuelto | Descripción |
|---|---|
|
La extensión DMA no implementa la función especificada por FunctionNumber. |
Observaciones
ConfigureAdapterChannel 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.
Use ConfigureAdapterChannel solo para adaptadores DMA del sistema. No use esta rutina para un adaptador de bus-master.
Un controlador DMA del sistema determinado puede tener características de hardware especiales a las que los controladores de dispositivo pueden acceder a través de un conjunto de una o varias funciones personalizadas. Un controlador puede implementar más de una función personalizada, en cuyo caso cada función se identifica mediante un número de función diferente. Estas funciones abstraen las características de hardware DMA para que se puedan admitir las mismas funciones en distintas plataformas de hardware.
Normalmente, una función personalizada establece información de estado en el controlador DMA para configurar las características de hardware para usarlas en transferencias DMA posteriores.
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 |