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 要求の一般的な情報については、「 Framework 要求オブジェクトの作成」を参照してください。

戻り値

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 バージョンの概要」を参照してください。

要件

要件	値
Header	acxstreams.h
IRQL	PASSIVE_LEVEL

こちらもご覧ください

• acxstreams.h ヘッダー