次の方法で共有


PcAddStreamResource 関数 (portcls.h)

PcAddStreamResource はストリーム リソースを追加します。 2 種類のストリーム リソースがサポートされています。割り込みとドライバー所有のスレッドです。 PcAddStreamResource は、オーディオ ストリームに関連付けられている割り込み/スレッドを持つオーディオ以外の WaveRT ミニポート ドライバーによって呼び出すことができます。 また、オーディオ WaveRT ミニポート ドライバーによって呼び出すこともできます。

構文

PORTCLASSAPI NTSTATUS PcAddStreamResource(
  [in]  PDEVICE_OBJECT               PhysicalDeviceObject,
  [in]  PVOID                        ResourceSet,
  [in]  PPCSTREAMRESOURCE_DESCRIPTOR ResourceDescriptor,
  [out] PCSTREAMRESOURCE             *ResourceHandle
);

パラメーター

[in] PhysicalDeviceObject

PDEVICE_OBJECT - このリソースを使用するデバイス スタックの PDO。

[in] ResourceSet

PVOID - 将来使用するために予約され、NULL に設定されます。 現時点では、デバイス スコープのリソースのみがサポートされています。

[in] ResourceDescriptor

PPCSTREAMRESOURCE_DESCRIPTOR - 追加するリソース。 詳細については、「 PCSTREAMRESOURCE_DESCRIPTOR」を参照してください。

[out] ResourceHandle

PCSTREAMRESOURCE* - リソース ハンドルを保持する場所。 詳細については、「 PcRemoveStreamResource」を参照してください。

戻り値

STATUS_SUCCESS – ドライバーは、指定された PDO のリソースを登録できました。

STATUS_INVALID_PARAMETER – ドライバーは、他のエラー状態インスタンスの特定のケースを除いて、無効な他のパラメーターが見つかると、このエラーを返します。

追加の標準状態コードが返される場合があります。

注釈

問題のない操作を確実に行うために、オーディオ ドライバーはストリーミング リソースを portcls に登録する必要があります。 これにより、OS はリソースを管理して、オーディオ ストリーミングと他のサブシステム間の干渉を回避できます。

Streamリソースは、オーディオ ストリームを処理したり、オーディオ データ フローを確保したりするためにオーディオ ドライバーによって使用されるすべてのリソースです。

すべてのオーディオ ドライバーは、ストリーム リソースをオーディオ クラス ドライバーに登録する必要があります。 ドライバーは、割り込み、ドライバー所有のスレッド、および他のオーディオ スタックのリソースへの依存関係 (並列オーディオ ドライバー スタックなど) のリソースの種類を登録します。 詳細については、 PCSTREAMRESOURCE_DESCRIPTOR の定義を参照してください。

オーディオ ドライバーは、この呼び出しを行うときにリソースが有効であることを確認する必要があります。

Windows 10でのみ実行されるオーディオ ドライバーでは、PcAddStreamResourcePcRemoveStreamResource を使用できます。 以前のバージョンの Windows でも実行する必要があるオーディオ waveRT ミニポート ドライバーの場合は、 AddStreamResourceRemoveStreamResource を使用します。

要件

要件
サポートされている最小のクライアント Windows 10
サポートされている最小のサーバー Windows Server 2016
対象プラットフォーム Windows
ヘッダー portcls.h
Library Portcls.lib
[DLL] NA
IRQL PASSIVE_LEVEL

こちらもご覧ください

PCSTREAMRESOURCE_DESCRIPTOR

PcRemoveStreamResource