Méthode IKsDeviceFunctions ::RegisterAdapterObjectEx (ks.h)

Article
02/29/2024

La méthode IKsDeviceFunctions ::RegisterAdapterObjectEx inscrit un objet adaptateur DMA avec AVStream. Tous les pilotes compilés pour les plateformes Win64 doivent utiliser cette méthode au lieu de KsDeviceRegisterAdapterObject.

Syntaxe

NTSTATUS RegisterAdapterObjectEx(
  [in] PADAPTER_OBJECT     AdapterObject,
  [in] PDEVICE_DESCRIPTION DeviceDescription,
  [in] ULONG               NumberOfMapRegisters,
  [in] ULONG               MaxMappingsByteCount,
  [in] ULONG               MappingTableStride
);

Paramètres

[in] AdapterObject

Pointeur vers le ADAPTER_OBJECT de l’appareil. Doit être acquis via IoGetDmaAdapter avant d’appeler RegisterAdapterObjectEx.

[in] DeviceDescription

Pointeur vers une structure de type DEVICE_DESCRIPTION qui décrit les attributs de l’appareil physique pour lequel l’appelant inscrit un objet DMA.

[in] NumberOfMapRegisters

Spécifie le nombre de registres de carte retournés par l’appel du minidriver à IoGetDmaAdapter.

[in] MaxMappingsByteCount

Spécifie le nombre maximal d’octets que l’appareil peut gérer pour un mappage unique. Permet à AVStream de décomposer automatiquement de grands blocs de mémoire physique contiguë en plusieurs éléments de diffusion/collecte pour les appareils qui imposent une limite de taille aux mappages individuels dans les transferts DMA. Consultez des informations supplémentaires importantes sur MaxMappingsByteCount sur la page de référence KsDeviceRegisterAdapterObject .

[in] MappingTableStride

Spécifie le nombre d’octets requis par chaque entrée de la table de mappage. Cette valeur doit être d’au moins sizeof (KSMAPPING) et peut être aussi grande que nécessaire.

Un espace supplémentaire peut être utilisé par le minidriver comme informations de contexte.

Valeur retournée

RegisterAdapterObjectEx retourne STATUS_SUCCESS si l’objet DMA a été inscrit avec succès. La méthode retourne STATUS_INSUFFICIENT_RESOURCES si la mémoire n’est pas suffisante.

Remarques

Consultez également Prise en charge de DMA dans les pilotes AVStream 64 bits.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Microsoft Windows Server 2003 avec Service Pack 1 (SP1) et versions ultérieures de Windows.
Plateforme cible	Universal
En-tête	ks.h (inclure Ks.h)

Voir aussi

KsDeviceRegisterAdapterObject

Partager via