Compartilhar via

Função AcxTargetElementFormatRequestForMethod (acxtargets.h)

  • Artigo

A função AcxTargetElementFormatRequestForMethod formata um WDFREQUEST como uma solicitação de método ACX a ser usada no destino do elemento especificado.

Sintaxe

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

Parâmetros

TargetElement

Um identificador ACXTARGETELEMENT. Para obter mais informações sobre objetos ACX, consulte Resumo de objetos ACX.

Request

Um identificador WDFREQUEST descrito em Resumo de Objetos de Estrutura. Para obter informações gerais sobre solicitações do WDF, consulte Criando objetos de solicitação de estrutura.

Params

Uma estrutura de ACX_REQUEST_PARAMETERS inicializada usada para armazenar informações de parâmetro de solicitação de método.

Retornar valor

Retorna STATUS_SUCCESS se a chamada foi bem-sucedida. Caso contrário, ele retornará um código de erro apropriado. Para obter mais informações, consulte Usando valores NTSTATUS.

Comentários

Um WDFREQUEST é uma solicitação de E/S criada pelo driver. Os drivers baseados em estrutura processam cada solicitação de E/S chamando métodos de objeto de solicitação de estrutura. Para obter mais informações, consulte Objetos de solicitação de estrutura.

Exemplo

Este código de exemplo mostra o 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 do ACX

Versão mínima do ACX: 1.0

Para obter mais informações sobre versões do ACX, consulte Visão geral da versão do ACX.

Requisitos

Requisito Valor
Cabeçalho acxtargets.h
IRQL PASSIVE_LEVEL

Confira também