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でのみ実行されるオーディオ ドライバーでは、PcAddStreamResource と PcRemoveStreamResource を使用できます。 以前のバージョンの Windows でも実行する必要があるオーディオ waveRT ミニポート ドライバーの場合は、 AddStreamResource と RemoveStreamResource を使用します。

要件

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

こちらもご覧ください

PCSTREAMRESOURCE_DESCRIPTOR

PcRemoveStreamResource