PcNewDmaChannel 関数 (portcls.h)

PcNewDmaChannel 関数は、新しい DMA チャネル オブジェクトを作成します。 この関数は廃止されました。詳細については、次のコメントを参照してください。

構文

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

パラメーター

[out] OutDmaChannel

この関数によって作成された DMA チャネル オブジェクトの出力ポインター。 このパラメーターは、新しく作成された IDmaChannel オブジェクトへの参照を関数が出力する呼び出し元によって割り当てられたポインター変数を指します。 このパラメーターに有効な NULL 以外のポインター値を指定します。

[in, optional] OuterUnknown

オブジェクトを集計する必要があるオブジェクトの IUnknown インターフェイスへのポインター。 集計が必要な場合を除き、このパラメーターを NULL に設定 します。

[in] PoolType

オブジェクトの割り当て元となる記憶域プールの種類を指定します。 これは 、POOL_TYPE 列挙値です。 このパラメーターに非ページ プールの種類を指定します。

[in] DeviceDescription

呼び出し元が DMA オブジェクトを要求している物理デバイスの説明へのポインター。 このパラメーターは、 DEVICE_DESCRIPTION型の構造体を指します。

[in] DeviceObject

物理アダプター デバイスのデバイス オブジェクトへのポインター。 このパラメーターは、 DEVICE_OBJECT 型のシステム構造を指します。

戻り値

PcNewDmaChannel は 、呼び出しが成功した場合にSTATUS_SUCCESSを返します。 それ以外の場合は、適切なエラー コードを返します。

注釈

PcNewDmaChannel は廃止されました。 すべての新しいオーディオ ドライバーに対して、PcNewDmaChannel の代わりに次のいずれかの IPortWave Xxx::NewXxxDmaChannel メソッドを使用します。

IPortWavePci::NewMasterDmaChannel

IPortWaveCyclic::NewMasterDmaChannel

IPortWaveCyclic::NewSlaveDmaChannel

下位互換性のために、PortCls システム ドライバーは引き続き PcNewDmaChannel をサポートし、既存のドライバーはこの関数を引き続き使用できます。

PoolType パラメーターを、POOL_TYPE 列挙で定義されている非ページ プールの種類の 1 つに指定します。 IDmaChannel インターフェイス内のいくつかのメソッドは IRQL DISPATCH_LEVELから呼び出すことができるため、DMA チャネル オブジェクトはページ メモリ内に存在してはなりません。

OutDmaChannel パラメーターと OuterUnknown パラメーターは、COM オブジェクトの参照カウント規則に従います。

注意

Microsoft は、多様で包括的な環境をサポートしています。 この記事には、 バイアスフリー通信の Microsoft スタイル ガイド で除外として認識される用語への参照が含まれています。 この記事では、ソフトウェアに現在表示されているため、一貫性を保つ目的で単語または語句を使用します。 言語を削除するようにソフトウェアが更新されると、この記事は一致するように更新されます。

要件

要件	値
サポートされている最小のクライアント	互換性のために残されています。 すべての新しいオーディオ ドライバーでは、代わりに IPortWaveXxx::NewXxxDmaChannel メソッドを使用します。 PortCls システム ドライバーは、Microsoft Windows 98/Me および Windows 2000 以降のオペレーティング システムで PcNewDmaChannel 関数を実装します。
対象プラットフォーム	ユニバーサル
Header	portcls.h (Portcls.h を含む)
Library	Portcls.lib
IRQL	PASSIVE_LEVEL

こちらもご覧ください

DEVICE_DESCRIPTION

DEVICE_OBJECT

IDmaChannel

POOL_TYPE