PcRemoveStreamResource 関数 (portcls.h)
PcRemoveStreamResource は、既存のストリーム リソースを削除します。 PcRemoveStreamResource は、オーディオ ストリームに関連付けられた割り込み/スレッドを持つ、オーディオ以外の WaveRT ミニポート ドライバーを含む任意のドライバーによって呼び出すことができます。 また、オーディオ WaveRT ミニポート ドライバーによって呼び出すこともできます。
構文
PORTCLASSAPI NTSTATUS PcRemoveStreamResource(
[in] PCSTREAMRESOURCE ResourceHandle
);
パラメーター
[in] ResourceHandle
PCSTREAMRESOURCE – PcAddStreamResource によって返されるリソース ハンドル。
詳細については、「 PcAddStreamResource 」および 「PCSTREAMRESOURCE_DESCRIPTOR」を参照してください。
戻り値
STATUS_SUCCESS – ドライバーは、指定された PDO のリソースを登録できました。
STATUS_INVALID_PARAMETER – ドライバーは、他のエラー状態インスタンスの特定のケースとは別に、無効な他のパラメーターが見つかると、このエラーを返します。
追加の標準状態コードが返される場合があります。
注釈
グリッチフリー操作を確実に行うには、オーディオ ドライバーがストリーミング リソースを portcls に登録する必要があります。 これにより、OS はリソースを管理して、オーディオ ストリーミングと他のサブシステム間の干渉を回避できます。
Streamリソースは、オーディオ ストリームを処理したり、オーディオ データ フローを確保したりするためにオーディオ ドライバーによって使用されるリソースです。
オーディオ ドライバーは、以前に登録されたリソースを削除する必要があります。 ドライバーは、次のシステム アクティビティの結果としてリソースの登録を解除できます。
- I/O リソースが変更されたときにデバイスのバランスを再調整します。
- リソースが破棄または作成されたときのデバイスの電源切り替え (D0< - ->Dx)。 たとえば、Dx で行うときに割り込みが切断され、D0 に戻って再接続される場合があります。
- 停止を処理する場合は、プラグ アンド プレイ イベントを突然削除し、削除します。
- 関連付けられたオーディオ エンドポイントが消えるとき。 たとえば、エンドポイントのデータ ストリームを処理するスレッドが作成され、エンドポイントが削除された場合などです。 この場合、ドライバーはスレッド ストリーム リソースを削除する必要があります。
Windows 10でのみ実行されるオーディオ ドライバーでは、PcAddStreamResource と PcRemoveStreamResource を使用できます。 以前のバージョンの Windows でも実行する必要があるオーディオ waveRT ミニポート ドライバーの場合は、 AddStreamResource と RemoveStreamResource を使用します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 10 |
| サポートされている最小のサーバー | Windows Server 2016 |
| 対象プラットフォーム | Windows |
| ヘッダー | portcls.h |
| Library | Portcls.lib |
| [DLL] | NA |
| IRQL | PASSIVE_LEVEL |