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

こちらもご覧ください

PCSTREAMRESOURCE_DESCRIPTOR

PcAddStreamResource

PcStreamResourceType