Share via

Função AcxTargetElementFormatRequestForProperty (acxtargets.h)

  • Artigo

A função AcxTargetElementFormatRequestForProperty formata um WDFREQUEST como uma solicitação de propriedade ACX a ser usada no destino do elemento especificado.

Sintaxe

NTSTATUS AcxTargetElementFormatRequestForProperty(
  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 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 propriedade.

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


    ACX_REQUEST_PARAMETERS      params;
    WDFREQUEST                  req;
    ACXTARGETELEMENT            targetElement;

...

    status = AcxTargetElementFormatRequestForProperty(targetElement, 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