次の方法で共有

IPortClsStreamResourceManager::RemoveStreamResource メソッド (portcls.h)

  • [アーティクル]

RemoveStreamResource は、既存のストリーム リソースを削除します。 RemoveStreamResource メソッドは、オーディオ waveRT ミニポート ドライバーでのみ使用できます。

構文

NTSTATUS RemoveStreamResource(
  PCSTREAMRESOURCE ResourceHandle
);

パラメーター

ResourceHandle

PCSTREAMRESOURCE – PcAddStreamResource によって返されるリソース ハンドル。 詳細については、「PcAddStreamResource」を参照してください。

戻り値

このメソッドは、次を含む NTSTATUS を返します。

  • STATUS_SUCCESS – ドライバーは、指定された PDO のリソースを登録できました。
  • STATUS_INVALID_PARAMETER – ドライバーは、他のエラー状態インスタンスの特定のケースを除いて、無効な他のパラメーターが見つかると、このエラーを返します。

追加の標準状態コードが返される場合があります。

備考

障害のない操作を確実に行うには、オーディオ ドライバーがストリーミング リソースを portcls に登録する必要があります。 これにより、OS はリソースを管理して、オーディオ ストリーミングと他のサブシステム間の干渉を回避できます。 ストリーム リソースは、オーディオ ストリームを処理したり、オーディオ データ フローを確保したりするためにオーディオ ドライバーによって使用されるすべてのリソースです。

オーディオ ドライバーは、以前に登録されたリソースを削除する必要があります。 ドライバーは、次のシステム アクティビティの結果としてリソースの登録を解除できます。

  • I/O リソースが変更されたときにデバイスのバランスを再調整します。
  • リソースが破棄または作成されると、デバイスの電源切り替え (D0<- ->Dx)。 たとえば、割り込みは Dx で行うときに切断され、D0 に戻るときに再接続される場合があります。
  • 処理の停止、突然の削除、プラグ アンド プレイ イベントの削除。
  • 関連付けられているオーディオ エンドポイントが消えたとき。 たとえば、エンドポイントのデータ ストリームを処理するスレッドが作成され、エンドポイントが削除された場合などです。 この場合、ドライバーはスレッド ストリーム リソースを削除する必要があります。

オーディオ ドライバーは、この呼び出しを行うときにリソースが有効であることを確認する必要があります。

必要条件

要件 価値
ヘッダー portcls.h
IRQL PASSIVE_LEVEL

関連項目

IPortClsStreamResourceManager の