IKsDeviceFunctions::RegisterAdapterObjectEx-Methode (ks.h)

Die IKsDeviceFunctions::RegisterAdapterObjectEx--Methode registriert ein DMA-Adapterobjekt bei AVStream. Alle für Win64-Plattformen kompilierten Treiber sollten diese Methode anstelle von KsDeviceRegisterAdapterObjectverwenden.

Syntax

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

Parameter

[in] AdapterObject

Zeigen Sie auf das 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 IoGetDmaAdapterzurü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 des zusammenhängenden physischen Speichers automatisch in mehrere Punkt-/Sammelelemente für Geräte aufzuteilen, die eine Größenbeschränkung für einzelne Zuordnungen in DMA-Übertragungen auferlegen. Wichtige zusätzliche Informationen zu MaxMappingsByteCount- finden Sie auf der KsDeviceRegisterAdapterObject Referenzseite.

[in] MappingTableStride

Gibt an, wie viele Bytes jeder Eintrag in der Zuordnungstabelle benötigt. Dieser Wert muss mindestens Größe von (KSMAPPING) sein und kann bei Bedarf so groß 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.

Bemerkungen

Siehe auch Unterstützen von DMA in 64-Bit-AVStream-Treibern.

Anforderungen

Siehe auch

KsDeviceRegisterAdapterObject