次の方法で共有


AVCSTRM_GET_STATE

AVCSTRM_GET_STATE 関数コードは、指定したストリームの現在のストリーム状態を取得します。

I/O ステータス ブロック

成功した場合、avcstrm.sysIrp->IoStatus.Status を STATUS_SUCCESSに設定します。

成功した場合は、STATUS_SUCCESS が返されます。 CommandData 共用体の StreamState メンバーには、現在のストリーム状態があります。 KSSTATE_STOP、KSTATE_PAUSE、または KSSTATE_RUN にできます。

指定できる値は以下の通りです。

エラーの状態 説明
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_GET_STATE を渡します。

AVCStreamContext
ストリームの状態を取得する前の AVCSTRM_OPEN 呼び出しによって返されるストリーム コンテキスト (ハンドル) を指定します。

StreamState
AVCSTRM_GET_STATE が正常に返された場合、このメンバーには現在のストリーム状態が含まれます。

サブユニット ドライバーは、最初に IRP と AVC_STREAM_REQUEST_BLOCK 構造体を割り当てる必要があります。 次に、INIT_AVCSTRM_HEADER マクロを使用して AVC_STREAM_REQUEST_BLOCK 構造体を初期化し、AVCSTRM_GET_STATE を Request 引数としてマクロに渡す必要があります。 次に、サブユニット ドライバーは、ストリームの状態を取得するストリームのストリーム コンテキスト (ハンドル) に AVCStreamContext メンバーを設定します。

この要求を送信するには、サブユニットは、IOCTL_AVCSTRM_CLASS に設定された IRP のIoControlCode メンバーと、ストリーム状態を取得する前のストリームを記述する AVC_STREAM_REQUEST_BLOCK 構造体に設定された IRP の Argument1 メンバーを持つ IRP_MJ_INTERNAL_DEVICE_CONTROL IRP を送信します。

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

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

Comments

この関数は、次に示すように、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.h宣言されています。 avcstrm.h を含めます。

参照

AVC_STREAM_REQUEST_BLOCK

INIT_AVCSTRM_HEADER

IRP_MJ_INTERNAL_DEVICE_CONTROL

IOCTL_AVCSTRM_CLASS

KSSTATE

AVCSTRM_FUNCTION