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 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 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

Ninguno

Observaciones

Normalmente, un controlador llama a WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT desde su EvtDevicePrepareHardware función de devolución de llamada. 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 podría 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	Valor
cliente mínimo admitido	Windows 8
de la plataforma de destino de	Universal
versión mínima de KMDF	1.11
encabezado	wdfdmaenabler.h (incluya Wdf.h)

Consulte también

WDF_DMA_SYSTEM_PROFILE_CONFIG

WdfDmaEnablerConfigureSystemProfile

WdfDmaEnablerCrear