função WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT (wdfdmaenabler.h)

[Aplica-se somente ao KMDF]

A função WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT inicializa a estrutura de WDF_DMA_SYSTEM_PROFILE_CONFIG de um driver.

Sintaxe

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

Um ponteiro para uma estrutura de WDF_DMA_SYSTEM_PROFILE_CONFIG alocada por driver.

[in] Address

O endereço traduzido do registro para o destino do AMD. Para obter mais informações, consulte Comentários.

[in] DmaWidth

A largura do registro especificado por Address.

[in] DmaDescriptor

O descritor de recursos traduzido para o canal DMA atribuído ao dispositivo durante EvtDevicePrepareHardware.

Retornar valor

Nenhum

Comentários

Normalmente, um driver chama WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT de dentro de sua função de retorno de chamada EvtDevicePrepareHardware . Um driver deve chamar a função WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT antes de chamar WdfDmaEnablerConfigureSystemProfile.

Dependendo do design do SoC (Sistema em um Chip), o parâmetro Address pode ter um significado diferente. Por exemplo, se o AMD usar portas de transferência dedicadas no dispositivo, Address poderá indicar a porta na qual as gravações de DMA ocorrem.

Para obter mais informações sobre como criar um habilitador de DMA no modo de sistema, consulte Suporte System-Mode DMA.

Exemplos

Para obter um exemplo de código que usa WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT, consulte WdfDmaEnablerConfigureSystemProfile.

Requisitos

Confira também

WDF_DMA_SYSTEM_PROFILE_CONFIG

WdfDmaEnablerConfigureSystemProfile

WdfDmaEnablerCreate