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 版本概述。

要求

要求	价值
标头	acxtargets.h
IRQL	PASSIVE_LEVEL

另请参阅

• acxtargets.h 标头