AVCSTRM_SET_STATE

AVCSTRM_SET_STATE函式程式碼會將指定的資料流程放入新的資料流程狀態。

I/o 狀態欄塊

如果成功, avcstrm.sys 會將 IoStatus 的狀態設定 > 為 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、Version 和 Function
使用 INIT_AVCSTRM_HEADER 宏來初始化這些成員。 在宏的 Request 引數中傳遞 AVCSTRM_SET_STATE

AVCStreamCoNtext
指定資料流程內容 (處理先前 AVCSTRM_OPEN 呼叫所傳回的) ,以將其放入新的資料流程狀態。

StreamState
指定要放置資料流程的新資料流程狀態。

次級系統驅動程式必須先配置 IRP 和 AVC_STREAM_REQUEST_BLOCK 結構。

接下來,它應該使用 INIT_AVCSTRM_HEADER 宏來初始化 AVC_STREAM_REQUEST_BLOCK 結構,並將 AVCSTRM_GET_STATE 傳遞為宏的要求引數。

接下來,次級驅動程式會將 AVCStreamCoNtext 成員設定為數據流內容 (處理資料流程的) ,以從取得資料流程狀態。

若要傳送此要求,子單位會將 IRP 設定為IoControlCode成員的IRP_MJ_INTERNAL_DEVICE_CONTROL irp 提交至IOCTL_AVCSTRM_CLASS ,並將 irp 的引數 1成員設定為 AVC_STREAM_REQUEST_BLOCK 結構,以描述要放入新資料流程狀態的資料流程。

次級驅動程式會預期此命令會以同步方式完成。 結果會立即傳回,而不會 avcstrm.sys中的暫止作業。

您必須在 IRQL = PASSIVE_LEVEL 呼叫這個函式程式碼。

註解

此函數會使用 AVC_STREAM_REQUEST_BLOCK 結構中CommandData聯集的StreamState成員,如下所示。

typedef struct _AVC_STREAM_REQUEST_BLOCK {
  ULONG  SizeOfThisBlock;
  ULONG  Version;
  AVCSTRM_FUNCTION  Function;
  .
  .
  PVOID AVCStreamContext;
  .
  .
  union _tagCommandData {
    .
    .
    KSSTATE  StreamState;
    .
    .
  } CommandData;
} AVC_STREAM_REQUEST_BLOCK, *PAVC_STREAM_REQUEST_BLOCK;

規格需求

頭:avcstrm中宣告。 包含avcstrm。

另請參閱

AVC_STREAM_REQUEST_BLOCK

INIT_AVCSTRM_HEADER

IRP_MJ_INTERNAL_DEVICE_CONTROL

IOCTL_AVCSTRM_CLASS

KSSTATE

AVCSTRM_FUNCTION