Partilhar via

Função AcxTargetCircuitCreate (acxtargets.h)

  • Artigo

A função AcxTargetCircuitCreate é usada para criar um circuito de destino ACX.

Sintaxe

NTSTATUS AcxTargetCircuitCreate(
  WDFDEVICE                  Device,
  PWDF_OBJECT_ATTRIBUTES     Attributes,
  PACX_TARGET_CIRCUIT_CONFIG Config,
  ACXTARGETCIRCUIT           *TargetCircuit
);

Parâmetros

Device

Um objeto WDFDEVICE (descrito em Resumo de Objetos framework) associado ao ACXCIRCUIT especificado.

Attributes

Atributos adicionais definidos usando uma estrutura WDF_OBJECT_ATTRIBUTES que são usados para definir valores de vários objetos: limpar e destruir retornos de chamada, tipo de contexto e especificar seu objeto pai.

Config

Uma estrutura de ACX_TARGET_CIRCUIT_CONFIG inicializada que descreve a configuração do circuito de destino.

TargetCircuit

Um ponteiro para um local que recebe um identificador para o novo objeto ACXTARGETCIRCUIT. Para obter mais informações sobre objetos ACX, consulte Resumo de objetos ACX.

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

Exemplo

    ACX_TARGET_CIRCUIT_CONFIG targetCfg;
    ACX_TARGET_CIRCUIT_CONFIG_INIT(&targetCfg);
    targetCfg.SymbolicLinkName = link;

    WDF_OBJECT_ATTRIBUTES_INIT(&attributes);
    attributes.ParentObject = Circuit;

    RETURN_NTSTATUS_IF_FAILED(AcxTargetCircuitCreate(AcxCircuitGetWdfDevice(Circuit), &attributes, &targetCfg, TargetCircuit));

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