PGET_DMA_ADAPTER_INFO fonction de rappel (wdm.h)

Article
08/08/2023

La routine GetDmaAdapterInfo récupère des informations sur les fonctionnalités matérielles d’un canal DMA système.

Syntaxe

PGET_DMA_ADAPTER_INFO PgetDmaAdapterInfo;

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

Paramètres

[in] DmaAdapter

Pointeur vers une structure DMA_ADAPTER . Cette structure est l’objet d’adaptateur qui représente le canal DMA système du pilote. L’appelant a obtenu ce pointeur à partir d’un appel précédent à la routine IoGetDmaAdapter .

[in, out] AdapterInfo

Pointeur vers une structure de DMA_ADAPTER_INFO allouée par l’appelant. La routine écrit des informations sur le contrôleur DMA système dans cette structure. L’appelant doit définir le membre Version de cette structure sur DMA_ADAPTER_INFO_VERSION1 avant d’appeler GetDmaAdapterInfo.

Valeur retournée

GetDmaAdapterInfo retourne STATUS_SUCCESS si l’appel réussit. Les valeurs de retour d’erreur possibles incluent le code status suivant.

Code de retour	Description
STATUS_NOT_SUPPORTED	La routine ne prend pas en charge la version spécifiée de la structure DMA_ADAPTER_INFO_XXX .

Remarques

GetDmaAdapterInfo n’est pas une routine système qui peut être appelée directement par nom. Cette routine peut être appelée uniquement par un pointeur à partir de l’adresse retournée dans une structure DMA_OPERATIONS. Les pilotes obtiennent l’adresse de cette routine en appelant IoGetDmaAdapter avec le membre Version du paramètre DeviceDescription défini sur DEVICE_DESCRIPTION_VERSION3. Si IoGetDmaAdapter retourne NULL, la routine n’est pas disponible sur votre plateforme.

GetDmaAdapterInfo récupère les informations suivantes :

Nombre maximal d’éléments dans une liste de points/regroupements que le contrôleur DMA peut traiter dans une seule opération DMA de diffusion/collecte.
Largeur, en bits, d’une adresse DMA.

Pour plus d’informations sur l’adaptateur DMA fourni par la version 1 de la structure DMA_ADAPTER_INFO_XXX , consultez DMA_ADAPTER_INFO_V1.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible à partir de Windows 8.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	wdm.h (inclure Wdm.h, Ntddk.h, Ntifs.h)
IRQL	<= DISPATCH_LEVEL

Voir aussi