AVCSTRM_ABORT_STREAMING
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 メンバーを設定します。
この要求を送信するには、サブユニットは、IOCTL_AVCSTRM_CLASS に設定された IoControlCode メンバーと、実行する中止ストリーミング操作を記述する AVC_STREAM_REQUEST_BLOCK 構造体に設定された IRP の Argument1 メンバーを持つ IRP_MJ_INTERNAL_DEVICE_CONTROL IRP を送信します。
この関数コードは、PASSIVE_LEVEL で呼び出す必要があります。 データ IRP を取り消すときは、DISPATCH_LEVEL で実行できます。 この場合、サブユニットは作業項目を開始し、その作業項目ルーチンでこの関数を呼び出す必要があります。この関数は、PASSIVE_LEVEL で実行されます。
Comments
この機能では、すべてのストリーミング 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;
要件
ヘッダー: avcstrm.h で宣言されています。 avcstrm.h を含めます。