AcxTargetPinFormatRequestForMethod 関数 (acxtargets.h)

  • [アーティクル]

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

構文

NTSTATUS AcxTargetPinFormatRequestForMethod(
  ACXTARGETPIN            TargetPin,
  WDFREQUEST              Request,
  PACX_REQUEST_PARAMETERS Params
);

パラメーター

TargetPin

既存の ACXTARGETPIN オブジェクト。 ACX オブジェクトの詳細については、「 ACX オブジェクトの概要」を参照してください。

Request

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

Params

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

戻り値

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

注釈

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

例

...
    _In_    ACXTARGETCIRCUIT TargetCircuit,
    _In_    ULONG            TargetPinId
    )

    NTSTATUS                    status;
    WDFREQUEST                  req;
    ACX_REQUEST_PARAMETERS      params;
    ACXTARGETPIN                targetPin = NULL;

...

    //
    // Get the target pin obj.
    //
    targetPin = AcxTargetCircuitGetTargetPin(TargetCircuit, TargetPinId);

    //
    // Format a WDF request for the target.
    //
    status = AcxTargetPinFormatRequestForMethod(targetPin, req, &params);

ACX の要件

最小 ACX バージョン: 1.0

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

要件

要件 値
Header acxtargets.h
IRQL PASSIVE_LEVEL

こちらもご覧ください