función WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT (wdfdmaenabler.h)
[Solo se aplica a KMDF]
La función WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT inicializa la estructura de WDF_DMA_SYSTEM_PROFILE_CONFIG de un controlador.
Sintaxis
void WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT(
PWDF_DMA_SYSTEM_PROFILE_CONFIG DmaConfig,
[in] PHYSICAL_ADDRESS Address,
[in] DMA_WIDTH DmaWidth,
[in] PCM_PARTIAL_RESOURCE_DESCRIPTOR DmaDescriptor
);
Parámetros
DmaConfig
Puntero a una estructura de WDF_DMA_SYSTEM_PROFILE_CONFIG asignada por el controlador.
[in] Address
Dirección traducida del registro al destino de DMA. Para obtener más información, vea la sección Comentarios.
[in] DmaWidth
Ancho del registro especificado por Address.
[in] DmaDescriptor
Descriptor de recursos traducido para el canal DMA asignado al dispositivo durante EvtDevicePrepareHardware.
Valor devuelto
None
Observaciones
Normalmente, un controlador llama a WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT desde su función de devolución de llamada EvtDevicePrepareHardware . Un controlador debe llamar a la función WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT antes de llamar a WdfDmaEnablerConfigureSystemProfile.
Según el diseño del sistema en un chip (SoC), el parámetro Address puede tener un significado diferente. Por ejemplo, si DMA usa puertos de transferencia dedicados en el dispositivo, Address podría indicar el puerto al que se producen las escrituras de DMA.
Para obtener más información sobre cómo crear un habilitador DMA en modo sistema, consulte Compatibilidad con System-Mode DMA.
Ejemplos
Para obtener un ejemplo de código que usa WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT, vea WdfDmaEnablerConfigureSystemProfile.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 8 |
| Plataforma de destino | Universal |
| Versión mínima de KMDF | 1.11 |
| Encabezado | wdfdmaenabler.h (include Wdf.h) |