AcxTargetCircuitFormatRequestForMethod 函式 (acxtargets.h)

AcxTargetCircuitFormatRequestForMethod 會將 WDFREQUEST 格式化為要用於指定線路目標的 ACX 方法要求。

語法

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

參數

TargetCircuit

ACXTARGETCIRCUIT 句柄。 如需 ACX 對象的詳細資訊，請參閱 ACX 物件的摘要。

Request

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

Params

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

傳回值

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

備註

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

範例

    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 標頭