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 はリソースを管理して、オーディオ ストリーミングと他のサブシステム間の干渉を回避できます。
ストリーム リソースは、オーディオ ストリームを処理したり、オーディオ データ フローを確保したりするためにオーディオ ドライバーによって使用されるすべてのリソースです。
すべてのオーディオ ドライバーは、オーディオ クラス ドライバーにストリーム リソースを登録する必要があります。 ドライバーは、割り込み、ドライバー所有のスレッド、および他のオーディオ スタックのリソースへの依存関係 (並列オーディオ ドライバー スタックなど) のリソースの種類を登録します。 詳細については、PCSTREAMRESOURCE_DESCRIPTOR の定義を参照してください。
オーディオ ドライバーは、この呼び出しを行うときにリソースが有効であることを確認する必要があります。
Windows 10 でのみ実行されるオーディオ ドライバーは、PcAddStreamResource と pcRemoveStreamResource 使用できます。 以前のバージョンの Windows でも実行する必要があるオーディオ waveRT ミニポート ドライバーの場合は、AddStreamResource を使用し、RemoveStreamResource をします。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 10 |
| サポートされる最小サーバー | Windows Server 2016 |
| ターゲット プラットフォーム の | ウィンドウズ |
| ヘッダー | portcls.h |
| ライブラリ | Portcls.lib |
| DLL | NA |
| IRQL | PASSIVE_LEVEL |