acxTargetPinFormatRequestForMethod 函式 (acxtargets.h)

AcxTargetPinFormatRequestForMethod 函式會將 WDFREQUEST 格式化為 ACX 方法要求，以用於指定的針腳目標。

語法

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

參數

TargetPin

現有的 ACXTARGETPIN 物件。 如需 ACX 對象的詳細資訊，請參閱 ACX 物件的摘要。

Request

Framework 物件摘要中所述的 WDFREQUEST 句柄。 如需 WDF 要求的一般資訊，請參閱 建立架構要求物件。

Params

初始化 ACX_REQUEST_PARAMETERS 結構，用來儲存方法要求參數資訊。

傳回值

如果呼叫成功，則傳 STATUS_SUCCESS 回 。 否則，它會傳回適當的錯誤碼。 如需詳細資訊，請參閱 使用NTSTATUS值。

備註

WDFREQUEST 是驅動程式建立的 I/O 要求。 架構型驅動程式會呼叫架構要求物件方法來處理每個 I/O 要求。 如需詳細資訊，請參閱 Framework 要求物件。

範例

...
    _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 版本概觀。

規格需求

需求	值
標頭	acxtargets.h
IRQL	PASSIVE_LEVEL

另請參閱

• acxtargets.h 標頭