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