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 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 mediante el objeto de adaptador. El controlador DMA y el controlador del dispositivo deben estar de acuerdo con 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
STATUS_NOT_IMPLEMENTED	La extensión DMA no implementa la función especificada por FunctionNumber.

Comentarios

ConfigureAdapterChannel no es una rutina del sistema a la que se puede llamar directamente por 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.

Use ConfigureAdapterChannel solo para adaptadores DMA del sistema. No use esta rutina para un adaptador 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 su uso en transferencias de DMA posteriores.

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_OPERATIONS

IoGetDmaAdapter