通过

AcxTargetElementFormatRequestForMethod 函数 (acxtargets.h)

  • 项目

AcxTargetElementFormatRequestForMethod 函数将 WDFREQUEST 格式化为要用于指定元素目标的 ACX 方法请求。

语法

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

参数

TargetElement

ACXTARGETELEMENT 句柄。 有关 ACX 对象的详细信息，请参阅 ACX 对象的摘要。

Request

框架对象摘要中所述的 WDFREQUEST 句柄。 有关 WDF 请求的一般信息，请参阅 创建框架请求对象。

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

另请参阅