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 |