AcxTargetElementFormatRequestForMethod 関数 (acxtargets.h)

  • [アーティクル]

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

構文

NTSTATUS AcxTargetElementFormatRequestForMethod(
  ACXTARGETELEMENT        TargetElement,
  WDFREQUEST              Request,
  PACX_REQUEST_PARAMETERS Params
);

パラメーター

TargetElement

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

Request

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

Params

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

戻り値

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

注釈

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

例

このサンプル コードは、AcxTargetElementFormatRequestForMethod の使用方法を示しています。


    {
        ACXTARGETELEMENT targetElement          = NULL;
        ULONG            targetElementId        = 0;
        ULONG            targetElementsCount    = AcxTargetCircuitGetElementsCount(TargetCircuit);
        arg     = elementArg;
        result  = 0;

        targetElement = AcxTargetCircuitGetTargetElement(TargetCircuit, targetElementId);       

        ACX_REQUEST_PARAMETERS_INIT_METHOD(
            &params,
            KSMETHODSETID_AcxTestMethod,
            KSMETHOD_ACXELEMENT_TEST_IN2OUT,
            AcxMethodVerbSend,
            AcxItemTypeElement,
            targetElementId,
            &arg, sizeof(arg),      // Value & size
            &result, sizeof(result) // Control & size
            );  

        //
        // Format a WDF request as an ACX method request for the ACX element target.
        //
        status = AcxTargetElementFormatRequestForMethod(targetElement, req, &params);

ACX の要件

最小 ACX バージョン: 1.0

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

要件

要件 値
Header acxtargets.h
IRQL PASSIVE_LEVEL

こちらもご覧ください