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

  • Artigo

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.

Código de retorno Descrição
STATUS_NOT_SUPPORTED
 A rotina não dá suporte à versão especificada da estrutura DMA_ADAPTER_INFO_XXX .

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.
Para obter informações sobre as informações do adaptador DMA fornecidas pela versão 1 da estrutura DMA_ADAPTER_INFO_XXX , consulte DMA_ADAPTER_INFO_V1.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível a partir do Windows 8.
Plataforma de Destino Área de Trabalho
Cabeçalho wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
IRQL <= DISPATCH_LEVEL

Confira também

DMA_ADAPTER

DMA_ADAPTER_INFO

DMA_OPERATIONS

IoGetDmaAdapter