PCONFIGURE_ADAPTER_CHANNEL fonction de rappel (wdm.h)
La routine ConfigureAdapterChannel appelle une fonction personnalisée implémentée par le contrôleur DMA représenté par un objet adaptateur.
Syntaxe
PCONFIGURE_ADAPTER_CHANNEL PconfigureAdapterChannel;
NTSTATUS PconfigureAdapterChannel(
[in] PDMA_ADAPTER DmaAdapter,
[in] ULONG FunctionNumber,
[in] PVOID Context
)
{...}
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] FunctionNumber
Nombre de la fonction personnalisée à sélectionner. Pour plus d’informations, consultez la section Remarques.
[in] Context
Pointeur vers les paramètres de configuration de la fonction personnalisée spécifiée par FunctionNumber. La fonction est implémentée par le contrôleur DMA et est accessible par un pilote de périphérique via l’objet adaptateur. Le contrôleur DMA et le pilote de périphérique doivent accepter la signification de ces paramètres de configuration. Les données qui Contexte pointent est opaque pour le système d’exploitation.
Valeur de retour
ConfigureAdapterChannel retourne STATUS_SUCCESS si l’appel réussit. Les valeurs de retour d’erreur possibles incluent le code d’état suivant.
| Valeur de retour | Description |
|---|---|
|
L’extension DMA n’implémente pas la fonction spécifiée par FunctionNumber. |
Remarques
ConfigureAdapterChannel 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.
Utilisez ConfigureAdapterChannel uniquement pour les adaptateurs DMA système. N’utilisez pas cette routine pour un adaptateur bus-master.
Un contrôleur DMA système particulier peut avoir des fonctionnalités matérielles spéciales auxquelles les pilotes de périphérique peuvent accéder via un ensemble d’une ou plusieurs fonctions personnalisées. Un contrôleur peut implémenter plusieurs fonctions personnalisées, auquel cas chaque fonction est identifiée par un numéro de fonction différent. Ces fonctions résument les fonctionnalités matérielles DMA afin que les mêmes fonctions puissent être prises en charge sur différentes plateformes matérielles.
En règle générale, une fonction personnalisée définit les informations d’état dans le contrôleur DMA pour configurer les fonctionnalités matérielles à utiliser dans les transferts DMA suivants.
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 |