Partilhar via


Função AcxTargetCircuitFormatRequestForProperty (acxtargets.h)

O AcxTargetCircuitFormatRequestForProperty formata um WDFREQUEST como uma solicitação de propriedade ACX a ser usada no destino do circuito especificado.

Sintaxe

NTSTATUS AcxTargetCircuitFormatRequestForProperty(
  ACXTARGETCIRCUIT        TargetCircuit,
  WDFREQUEST              Request,
  PACX_REQUEST_PARAMETERS Params
);

Parâmetros

TargetCircuit

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

Request

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

Params

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

Valor de retorno

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.

Observações

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 de Objetos de Solicitação da Estrutura.

Exemplo


    ACX_REQUEST_PARAMETERS      params;
    WDFREQUEST                  req;
    ACXTARGETCIRCUIT            targetCircuit;

...

    //
    // Format a WDF request as an ACX property request for the ACX circuit target.
    //
    status = AcxTargetCircuitFormatRequestForProperty(targetCircuit, 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

Consulte também