PCONFIGURE_ADAPTER_CHANNEL fonction de rappel (wdm.h)

  • Article

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 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] FunctionNumber

Numéro de la fonction personnalisée à sélectionner. Pour plus d'informations, consultez la section Notes.

[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 s’entendre sur la signification de ces paramètres de configuration. Les données vers laquelle pointe Context sont opaques pour le système d’exploitation.

Valeur retournée

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

Valeur retournée Description
STATUS_NOT_IMPLEMENTED
 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 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.

Utilisez ConfigureAdapterChannel uniquement pour les adaptateurs DMA système. N’utilisez pas cette routine pour un adaptateur master bus.

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 abstraction des 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.

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

DMA_ADAPTER

DMA_OPERATIONS

IoGetDmaAdapter