共用方式為


acxTargetElementFormatRequestForMethod 函式 (acxtargets.h)

AcxTargetElementFormatRequestForMethod 函式會將 WDFREQUEST 格式化為要用於指定項目目標上的 ACX 方法要求。

語法

NTSTATUS AcxTargetElementFormatRequestForMethod(
  ACXTARGETELEMENT        TargetElement,
  WDFREQUEST              Request,
  PACX_REQUEST_PARAMETERS Params
);

參數

TargetElement

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

Request

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

Params

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

傳回值

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

備註

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

範例

此範例程式代碼示範如何使用 AcxTargetElementFormatRequestForMethod。


    {
        ACXTARGETELEMENT targetElement          = NULL;
        ULONG            targetElementId        = 0;
        ULONG            targetElementsCount    = AcxTargetCircuitGetElementsCount(TargetCircuit);
        arg     = elementArg;
        result  = 0;

        targetElement = AcxTargetCircuitGetTargetElement(TargetCircuit, targetElementId);       

        ACX_REQUEST_PARAMETERS_INIT_METHOD(
            &params,
            KSMETHODSETID_AcxTestMethod,
            KSMETHOD_ACXELEMENT_TEST_IN2OUT,
            AcxMethodVerbSend,
            AcxItemTypeElement,
            targetElementId,
            &arg, sizeof(arg),      // Value & size
            &result, sizeof(result) // Control & size
            );  

        //
        // Format a WDF request as an ACX method request for the ACX element target.
        //
        status = AcxTargetElementFormatRequestForMethod(targetElement, req, &params);

ACX 需求

最小 ACX 版本: 1.0

如需 ACX 版本的詳細資訊,請參閱 ACX 版本概觀

規格需求

需求
標頭 acxtargets.h
IRQL PASSIVE_LEVEL

另請參閱