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)

Consulte también

WDF_DMA_SYSTEM_PROFILE_CONFIG

WdfDmaEnablerConfigureSystemProfile

WdfDmaEnablerCreate