AVCSTRM_ABORT_STREAMING

發行項
06/15/2023

AVCSTRM_ABORT_STREAMING函式程式碼會取消所有擱置的資料要求，並釋放所使用的資源。

I/O 狀態欄塊

如果成功， avcstrm.sys 會將 Irp-IoStatus.Status > 設定為 STATUS_SUCCESS。

可能的錯誤傳回值包括：

錯誤狀態	描述
STATUS_DEVICE_REMOVED	對應至 AVCSTRM_READ作業的裝置已不存在。
STATUS_CANCELLED	無法完成要求。
STATUS_INVALID_PARAMETER	IRP 中指定的參數不正確，
STATUS_INSUFFICIENT_RESOURCES	沒有足夠的系統資源可完成要求。
STATUS_PENDING	已收到要求，但需要進一步處理。 I/O 完成常式會處理最終回應。

AVC_STREAM_REQUEST_BLOCK輸入

SizeOfThisBlock、版本和函式
使用 INIT_AVCSTRM_HEADER 宏來初始化這些成員。在宏的 Request 引數中傳遞 AVCSTRM_ABORT_STREAMING 。

AVCStreamCoNtext
指定先前 AVCSTRM_OPEN 呼叫傳回的資料流程內容 (控制碼) ，該呼叫是資料寫入作業的目標。

子單位驅動程式必須先配置 IRP 和 AVC_STREAM_REQUEST_BLOCK 結構。

接下來，它應該使用 INIT_AVCSTRM_HEADER 宏來初始化AVC_STREAM_REQUEST_BLOCK結構，並將 AVCSTRM_READ 當做 Request 引數傳遞至宏。

接下來，子單位驅動程式會將 AVCStreamCoNtext 成員設定為數據流內容， (處理資料流程) 中止資料流程。

若要傳送此要求，子單位會提交 IRP 的 IRP_MJ_INTERNAL_DEVICE_CONTROL IRP，其中 IRP 的 IoControlCode 成員設定為 IOCTL_AVCSTRM_CLASS ，而 IRP 的 Argument1 成員會設定為 AVC_STREAM_REQUEST_BLOCK描述要執行的中止串流作業。

必須在PASSIVE_LEVEL呼叫此函式程式碼。取消資料 IRP 時，可以在DISPATCH_LEVEL執行。在此情況下，子單位應該會啟動工作專案，並在其工作專案常式中呼叫此函式，其會在PASSIVE_LEVEL執行。

註解

請注意，這項功能會取消所有串流 IRP。若要取消個別的 IRP，請使用 IoCancelIrp。

子單位在移除目標裝置或取消原始資料 IRP 以停止串流作業時，應該呼叫此專案。

此函式不會在 AVC_STREAM_REQUEST_BLOCK 結構中使用 CommandData 等位的任何成員。

typedef struct _AVC_STREAM_REQUEST_BLOCK {
  ULONG  SizeOfThisBlock;
  ULONG  Version;
  AVCSTRM_FUNCTION  Function;
  .
  .
  PVOID AVCStreamContext;
  .
  .
} AVC_STREAM_REQUEST_BLOCK, *PAVC_STREAM_REQUEST_BLOCK;