AcxTargetCircuitFormatRequestForMethod 関数 (acxtargets.h)

  • [アーティクル]

AcxTargetCircuitFormatRequestForMethod は、指定された回線ターゲットで使用される ACX メソッド要求として WDFREQUEST を書式設定します。

構文

NTSTATUS AcxTargetCircuitFormatRequestForMethod(
  ACXTARGETCIRCUIT        TargetCircuit,
  WDFREQUEST              Request,
  PACX_REQUEST_PARAMETERS Params
);

パラメーター

TargetCircuit

ACXTARGETCIRCUIT ハンドル。 ACX オブジェクトの詳細については、「 ACX オブジェクトの概要」を参照してください。

Request

「フレームワーク オブジェクトの概要」で説明されている WDFREQUEST ハンドル。 WDF 要求の一般的な情報については、「 Framework 要求オブジェクトの作成」を参照してください。

Params

メソッド要求パラメーター情報を格納するために使用される初期化された ACX_REQUEST_PARAMETERS 構造体。

戻り値

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

注釈

WDFREQUEST は、ドライバーによって作成された I/O 要求です。 フレームワーク ベースのドライバーは、フレームワーク要求オブジェクト メソッドを呼び出すことによって、各 I/O 要求を処理します。 詳細については、「 フレームワーク要求オブジェクト」を参照してください。

例


    ACX_REQUEST_PARAMETERS      params;
    WDFREQUEST                  req;
    ACXTARGETCIRCUIT            targetCircuit;

...

    //
    // Format a WDF request as an ACX method request for the ACX circuit target.
    //
    status = AcxTargetCircuitFormatRequestForMethod(targetCircuit, req, &params);

ACX の要件

最小 ACX バージョン: 1.0

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

要件

要件 値
Header acxtargets.h
IRQL PASSIVE_LEVEL

こちらもご覧ください