通过

AcxTargetPinFormatRequestForMethod 函数 (acxtargets.h)

  • 项目

AcxTargetPinFormatRequestForMethod 函数将 WDFREQUEST 格式化为要用于指定引脚目标的 ACX 方法请求。

语法

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

参数

TargetPin

现有的 ACXTARGETPIN 对象。 有关 ACX 对象的详细信息，请参阅 ACX 对象的摘要。

Request

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

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

另请参阅