AcxTargetCircuitFormatRequestForMethod 函数 (acxtargets.h)

AcxTargetCircuitFormatRequestForMethod 将 WDFREQUEST 格式化为要用于指定线路目标的 ACX 方法请求。

语法

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

参数

TargetCircuit

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

Request

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

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

另请参阅

• acxtargets.h 标头