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 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 de IoGetDmaAdapter.
[in, out] AdapterInfo
Um ponteiro para uma estrutura de DMA_ADAPTER_INFO alocada pelo chamador. A rotina grava informações sobre o controlador DMA do sistema nessa estrutura. O chamador deve definir o membro Version dessa estrutura para DMA_ADAPTER_INFO_VERSION1 antes de chamar GetDmaAdapterInfo.
Valor de retorno
GetDmaAdapterInfo retornará STATUS_SUCCESS se a chamada for bem-sucedida. Os valores de retorno de erro possíveis incluem o código de status a seguir.
| Código de retorno | Descrição |
|---|---|
|
A rotina não dá suporte à versão especificada da estrutura deXXX DMA_ADAPTER_INFO_. |
Observações
GetDmaAdapterInfo não é uma rotina do sistema que pode ser chamada diretamente pelo nome. Essa rotina pode ser chamada apenas pelo ponteiro do endereço retornado em uma estrutura de DMA_OPERATIONS. Drivers obtêm o endereço dessa rotina chamando IoGetDmaAdapter com o membro de versão 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 DMA pode processar em uma única operação de DMA de dispersão/coleta.
- A largura, em bits, de um endereço DMA.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível a partir do Windows 8. |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| IRQL | <= DISPATCH_LEVEL |