IKsDeviceFunctions::RegisterAdapterObjectEx-Methode (ks.h)

Die IKsDeviceFunctions::RegisterAdapterObjectEx-Methode registriert ein DMA-Adapterobjekt bei AVStream. Alle Treiber, die für Win64-Plattformen kompiliert werden, sollten diese Methode anstelle von KsDeviceRegisterAdapterObject verwenden.

Syntax

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

Parameter

[in] AdapterObject

Zeiger auf den ADAPTER_OBJECT für das Gerät. Muss über IoGetDmaAdapter abgerufen werden, bevor RegisterAdapterObjectEx aufgerufen wird.

[in] DeviceDescription

Zeiger auf eine Struktur vom Typ DEVICE_DESCRIPTION , die die Attribute des physischen Geräts beschreibt, für das der Aufrufer ein DMA-Objekt registriert.

[in] NumberOfMapRegisters

Gibt die Anzahl der Kartenregister an, die vom Aufruf des Minidrivers an IoGetDmaAdapter zurückgegeben werden.

[in] MaxMappingsByteCount

Gibt die maximale Anzahl von Bytes an, die das Gerät für eine einzelne Zuordnung verarbeiten kann. Ermöglicht AVStream, große Teile zusammenhängenden physischen Arbeitsspeichers automatisch in mehrere Scatter-/Gather-Elemente für Geräte aufzuteilen, die eine Größenbegrenzung für einzelne Zuordnungen in DMA-Übertragungen festlegen. Weitere wichtige Informationen zu MaxMappingsByteCount finden Sie auf der KsDeviceRegisterAdapterObject-Referenzseite .

[in] MappingTableStride

Gibt an, wie viele Bytes für jeden Eintrag in der Zuordnungstabelle erforderlich sind. Dieser Wert muss mindestens sizeof (KSMAPPING) sein und kann so groß wie nötig sein.

Zusätzlicher Speicherplatz kann vom Minidriver als Kontextinformationen verwendet werden.

Rückgabewert

RegisterAdapterObjectEx gibt STATUS_SUCCESS zurück, wenn das DMA-Objekt erfolgreich registriert wurde. Die Methode gibt STATUS_INSUFFICIENT_RESOURCES zurück, wenn nicht genügend Arbeitsspeicher verfügbar ist.

Hinweise

Weitere Informationen finden Sie unter Unterstützen von DMA in 64-Bit-AVStream-Treibern.

Anforderungen

Weitere Informationen

KsDeviceRegisterAdapterObject