PcNewDmaChannel-Funktion (portcls.h)

Artikel
02/26/2024

Die PcNewDmaChannel-Funktion erstellt ein neues DMA-Kanalobjekt. Diese Funktion ist veraltet. Weitere Informationen finden Sie in den folgenden Kommentaren.

Syntax

PORTCLASSAPI NTSTATUS PcNewDmaChannel(
  [out]          PDMACHANNEL         *OutDmaChannel,
  [in, optional] PUNKNOWN            OuterUnknown,
  [in]           POOL_TYPE           PoolType,
  [in]           PDEVICE_DESCRIPTION DeviceDescription,
  [in]           PDEVICE_OBJECT      DeviceObject
);

Parameter

[out] OutDmaChannel

Ausgabezeiger für das von dieser Funktion erstellte DMA-Kanalobjekt. Dieser Parameter verweist auf eine vom Aufrufer zugewiesene Zeigervariable, in die die Funktion einen Verweis auf das neu erstellte IDmaChannel-Objekt ausgibt. Geben Sie einen gültigen Zeigerwert ohne NULL für diesen Parameter an.

[in, optional] OuterUnknown

Zeiger auf die IUnknown-Schnittstelle eines Objekts, das das Objekt aggregieren muss. Legen Sie diesen Parameter auf NULL fest, sofern keine Aggregation erforderlich ist.

[in] PoolType

Gibt den Typ des Speicherpools an, aus dem das Objekt zugeordnet werden soll. Dies ist ein POOL_TYPE Enumerationswert. Geben Sie einen nicht ausseitigen Pooltyp für diesen Parameter an.

[in] DeviceDescription

Zeiger auf eine Beschreibung des physischen Geräts, für das der Aufrufer ein DMA-Objekt anfordert. Dieser Parameter verweist auf eine Struktur vom Typ DEVICE_DESCRIPTION.

[in] DeviceObject

Zeiger auf das Geräteobjekt für das physische Adaptergerät. Dieser Parameter verweist auf eine Systemstruktur vom Typ DEVICE_OBJECT.

Rückgabewert

PcNewDmaChannel gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich war. Andernfalls wird ein entsprechender Fehlercode zurückgegeben.

Hinweise

PcNewDmaChannel ist veraltet. Verwenden Sie für alle neuen Audiotreiber eine der folgenden IPortWave Xxx::NewXxxDmaChannel-Methoden anstelle von PcNewDmaChannel:

IPortWavePci::NewMasterDmaChannel

IPortWaveCyclic::NewMasterDmaChannel

IPortWaveCyclic::NewSlaveDmaChannel

Aus Gründen der Abwärtskompatibilität unterstützt der PortCls-Systemtreiber weiterhin PcNewDmaChannel, und vorhandene Treiber können diese Funktion weiterhin verwenden.

Geben Sie den PoolType-Parameter als einen der in der POOL_TYPE-Enumeration definierten Nicht-Auslagerpooltypen an. Das DMA-Channel-Objekt darf sich nicht im ausgelagerten Speicher befinden, da mehrere Methoden in der IDmaChannel-Schnittstelle von IRQL DISPATCH_LEVEL aufgerufen werden können.

Die Parameter OutDmaChannel und OuterUnknown folgen den Referenzzählungskonventionen für COM-Objekte.

Hinweis

Microsoft unterstützt eine vielfältige und inklusive Umgebung. Dieser Artikel enthält Verweise auf Terminologie, die im Microsoft-Stilleitfaden für biasfreie Kommunikation als ausschließend anerkannt wird. Das Wort oder der Ausdruck wird in diesem Artikel aus Gründen der Konsistenz verwendet, da er derzeit in der Software angezeigt wird. Wenn die Software aktualisiert wird, um die Sprache zu entfernen, wird dieser Artikel entsprechend aktualisiert.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Veraltet. Verwenden Sie für alle neuen Audiotreiber stattdessen eine IPortWaveXxx::NewXxxDmaChannel-Methode. Der PortCls-Systemtreiber implementiert die PcNewDmaChannel-Funktion in Microsoft Windows 98/Me und in Windows 2000 und höheren Betriebssystemen.
Zielplattform	Universell
Header	portcls.h (include Portcls.h)
Bibliothek	Portcls.lib
IRQL	PASSIVE_LEVEL

Weitere Informationen

Freigeben über