PGET_DMA_ADAPTER_INFO função de retorno de chamada (wdm.h)

A rotina GetDmaAdapterInfo recupera informações sobre as funcionalidades de hardware de um canal de DMA do sistema.

Sintaxe

PGET_DMA_ADAPTER_INFO PgetDmaAdapterInfo;

NTSTATUS PgetDmaAdapterInfo(
  [in]      PDMA_ADAPTER DmaAdapter,
  [in, out] PDMA_ADAPTER_INFO AdapterInfo
)
{...}

Parâmetros

[in] DmaAdapter

Um ponteiro para uma estrutura DMA_ADAPTER . Essa estrutura é o objeto do adaptador que representa o canal DMA do sistema do driver. O chamador obteve esse ponteiro de uma chamada anterior para a rotina IoGetDmaAdapter .

[in, out] AdapterInfo

Um ponteiro para uma estrutura de DMA_ADAPTER_INFO alocada pelo chamador. A rotina grava informações sobre o controlador de DMA do sistema nessa estrutura. O chamador deve definir o membro Version dessa estrutura como DMA_ADAPTER_INFO_VERSION1 antes de chamar GetDmaAdapterInfo.

Retornar valor

GetDmaAdapterInfo retornará STATUS_SUCCESS se a chamada for bem-sucedida. Os possíveis valores retornados por erro incluem o código de status a seguir.

Comentários

GetDmaAdapterInfo não é uma rotina do sistema que pode ser chamada diretamente pelo nome. Essa rotina só pode ser chamada pelo ponteiro do endereço retornado em uma estrutura DMA_OPERATIONS. Os drivers obtêm o endereço dessa rotina chamando IoGetDmaAdapter com o membro Version do parâmetro DeviceDescription definido como DEVICE_DESCRIPTION_VERSION3. Se IoGetDmaAdapter retornar NULL, a rotina não estará disponível em sua plataforma.

GetDmaAdapterInfo recupera as seguintes informações:

• O número máximo de elementos em uma lista de dispersão/coleta que o controlador de DMA pode processar em uma única operação de DMA de dispersão/coleta.
• A largura, em bits, de um endereço DMA.

Requisitos

Confira também

DMA_ADAPTER

DMA_ADAPTER_INFO

DMA_OPERATIONS

IoGetDmaAdapter