Compartir a través de

Función AcxTargetElementFormatRequestForMethod (acxtargets.h)

  • Artículo

La función AcxTargetElementFormatRequestForMethod da formato a un WDFREQUEST como una solicitud de método ACX que se usará en el destino de elemento especificado.

Sintaxis

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

Parámetros

TargetElement

Un identificador ACXTARGETELEMENT. Para obtener más información sobre los objetos ACX, vea Resumen de objetos ACX.

Request

Identificador WDFREQUEST descrito en Resumen de objetos de marco. Para obtener información general sobre las solicitudes de WDF, vea Creating Framework Request Objects.

Params

Estructura de ACX_REQUEST_PARAMETERS inicializada que se usa para almacenar información de parámetros de solicitud de método.

Valor devuelto

Devuelve STATUS_SUCCESS si la llamada se realizó correctamente. De lo contrario, devuelve un código de error adecuado. Para obtener más información, vea Using NTSTATUS Values.

Observaciones

WDFREQUEST es un controlador que creó solicitudes de E/S. Los controladores basados en marcos procesan cada solicitud de E/S mediante una llamada a métodos de objeto de solicitud de marco. Para obtener más información, vea Framework Request Objects.

Ejemplo

Este código de ejemplo muestra el uso de 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);

Requisitos de ACX

versión mínima de ACX: 1.0

Para obtener más información sobre las versiones de ACX, consulte introducción a la versión de ACX.

Requisitos

Requisito Valor
encabezado de acxtargets.h
irQL PASSIVE_LEVEL

Consulte también