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

另請參閱