次の方法で共有

AcxStreamDispatchAcxRequest 関数 (acxstreams.h)

  • [アーティクル]

AcxStreamDispatchAcxRequest は、WDFREQUEST フレームワーク要求オブジェクトを使用して ACX 要求をディスパッチします。 AcxStreamDispatchAcxRequest は、AcxStreamInitAssignAcxRequestPreprocessCallback を介して登録された EVT_ACX_OBJECT_PREPROCESS_REQUEST イベント ハンドラーのコンテキスト内で呼び出され、要求を ACX フレームワークで処理する必要があることを示します。

構文

NTSTATUS AcxStreamDispatchAcxRequest(
  ACXSTREAM  Stream,
  WDFREQUEST Request
);

パラメーター

Stream

既存の ACXSTREAM オブジェクト。 ACXSTREAM オブジェクトは、回線によって作成されたオーディオ ストリームを表します。 詳細については、ACX - ACX オブジェクトの概要を参照してください。

Request

EVT_ACX_OBJECT_PREPROCESS_REQUEST イベント ハンドラーに渡された WDFREQUEST オブジェクト ハンドル。 WDF 要求の一般的な情報については、「フレームワーク要求オブジェクトの作成 を参照してください。

戻り値

呼び出しが成功した場合に STATUS_SUCCESS を返します。 それ以外の場合は、適切なエラー コードが返されます。 詳細については、NTSTATUS 値 の使用に関するを参照してください。

備考

AcxStream オブジェクトのドライバーのEVT_ACX_OBJECT_PREPROCESS_REQUESTを呼び出す場合、ドライバーは WdfRequestComplete または AcxStreamDispatchAcxRequest を呼び出す必要がありますが、両方を呼び出す必要はありません。

例

使用例を次に示します。

VOID
Codec_EvtStreamRequestPreprocess(
    _In_    ACXOBJECT  Object,
    _In_    ACXCONTEXT DriverContext,
    _In_    WDFREQUEST Request
    )
/*++

Routine Description:

    This function is an example of a preprocess routine.

--*/
{
    //
    // Just give the request back to ACX. Normally the driver would take steps to examine
    // the Request and take action if necessary.
    //
    AcxStreamDispatchAcxRequest((ACXSTREAM)Object, Request);
}

ACX の要件

最小 ACX バージョン: 1.0

ACX バージョンの詳細については、ACX バージョンの概要 参照してください。

必要条件

要件 価値
ヘッダー acxstreams.h
IRQL PASSIVE_LEVEL

関連項目

  • acxstreams.h ヘッダー を する