Share via

Função AcxTargetPinFormatRequestForMethod (acxtargets.h)

  • Artigo

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

Sintaxe

NTSTATUS AcxTargetPinFormatRequestForMethod(
  ACXTARGETPIN            TargetPin,
  WDFREQUEST              Request,
  PACX_REQUEST_PARAMETERS Params
);

Parâmetros

TargetPin

Um objeto ACXTARGETPIN existente. Para obter mais informações sobre objetos ACX, consulte Resumo de objetos ACX.

Request

Um identificador WDFREQUEST descrito em Resumo de Objetos framework. 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

...
    _In_    ACXTARGETCIRCUIT TargetCircuit,
    _In_    ULONG            TargetPinId
    )

    NTSTATUS                    status;
    WDFREQUEST                  req;
    ACX_REQUEST_PARAMETERS      params;
    ACXTARGETPIN                targetPin = NULL;

...

    //
    // Get the target pin obj.
    //
    targetPin = AcxTargetCircuitGetTargetPin(TargetCircuit, TargetPinId);

    //
    // Format a WDF request for the target.
    //
    status = AcxTargetPinFormatRequestForMethod(targetPin, req, &params);

Requisitos do ACX

Versão mínima do ACX: 1.0

Para obter mais informações sobre as 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