fonction de rappel PGET_DMA_ADAPTER_INFO (wdm.h)
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 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 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 de retour
GetDmaAdapterInfo retourne STATUS_SUCCESS si l’appel réussit. Les valeurs de retour d’erreur possibles incluent le code d’état suivant.
| Retourner le code | Description |
|---|---|
|
La routine ne prend pas en charge la version spécifiée de la structureXXX DMA_ADAPTER_INFO_. |
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 le pointeur de l’adresse retournée dans une structure DMA_OPERATIONS. Pilotes obtiennent l’adresse de cette routine en appelant IoGetDmaAdapter avec le membre version du paramètre DeviceDes cription 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 nuage de points/collecte.
- Largeur, en bits, d’une adresse DMA.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible à partir de Windows 8. |
| plateforme cible | Bureau |
| d’en-tête | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| IRQL | <= DISPATCH_LEVEL |