AVCSTRM_CLOSE

[アーティクル]
04/04/2024

AVCSTRM_CLOSE 関数コードは、指定されたストリームを閉じ、AVCSTRM_OPEN に割り当てられているリソースをすべて解放します。

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_CLOSE を渡します。

AVCStreamContext
閉じるストリームのストリームコンテキスト (ハンドル) を指定します。 AVCSTRM_CLOSE が正常に返された場合、この値は無効になります。

閉じるストリームを指定する方法の例を次に示します。

    pAVCStrmReq = &pStrmExt->AVCStrmReq;
    RtlZeroMemory(pAVCStrmReq, sizeof(AVC_STREAM_REQUEST_BLOCK));
    INIT_AVCSTRM_HEADER(pAVCStrmReq, AVCSTRM_CLOSE);

    pAVCStrmReq->AVCStreamContext = pStrmExt->AVCStreamContext;

    Status = 
        AVCStrmReqSubmitIrpSynch ( 
            pDevExt->pBusDeviceObject,
            pStrmExt->pIrpReq,
            pAVCStrmReq
            );

サブユニットドライバーは、最初に IRP と AVC_STREAM_REQUEST_BLOCK 構造体を割り当てる必要があります。

次に、INIT_AVCSTRM_HEADER マクロを使用して AVC_STREAM_REQUEST_BLOCK 構造体を初期化し、AVCSTRM_CLOSE を Request 引数としてマクロに渡す必要があります。

次に、サブユニットドライバーは、AVCStreamContext メンバーを閉じるストリームに設定します。

この要求を送信するには、サブユニットは、IOCTL_AVCSTRM_CLASS に設定された IoControlCode メンバーと、実行する閉じ操作を記述する AVC_STREAM_REQUEST_BLOCK 構造体に設定された IRP の Argument1 メンバーを持つ IRP_MJ_INTERNAL_DEVICE_CONTROL IRP を送信します。

サブユニットドライバーは、このコマンドが同期的に完了することを期待できます。結果は、avcstrm.sys で保留中の操作なしで直ちに返されます。

この関数コードは、IRQL = PASSIVE_LEVEL で呼び出す必要があります。

Comments

この関数は、次に示すように、AVC_STREAM_REQUEST_BLOCK 構造体で CommandData 共用体の AVCStreamContext メンバーを使用します。

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