次の方法で共有


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

要件

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

こちらもご覧ください

PCSTREAMRESOURCE_DESCRIPTOR

PcAddStreamResource

PcStreamResourceType