EVT_ACX_CIRCUIT_COMPOSITE_INITIALIZE função de retorno de chamada (acxcircuit.h)

Importante

Algumas informações referem-se a um produto de pré-lançamento que pode ser substancialmente modificado antes de ser lançado comercialmente. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

O retorno de chamada EVT_ACX_CIRCUIT_COMPOSITE_INITIALIZE é usado pelo driver para fazer qualquer pós-inicialização depois que o ponto de extremidade composto for montado pelo Gerenciador ACX.

Sintaxe

EVT_ACX_CIRCUIT_COMPOSITE_INITIALIZE EvtAcxCircuitCompositeInitialize;

NTSTATUS EvtAcxCircuitCompositeInitialize(
  WDFDEVICE Device,
  ACXCIRCUIT Circuit,
  ACXOBJECTBAG CompositeProperties
)
{...}

Parâmetros

Device

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

Circuit

O objeto ACXCIRCUIT que está sendo inicializado. Para obter mais informações sobre objetos ACX, consulte Resumo de Objetos ACX.

CompositeProperties

Identificador opcional para CompositeProperties que descreve o circuito composto. Este é um objeto ACXOBJECTBAG opcional para as propriedades do ponto de extremidade composto.

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 Como usar valores NTSTATUS.

Comentários

Exemplo

Este código de exemplo mostra como o driver recupera uma propriedade composta do recipiente de objetos de propriedade composta especificado.

EVT_ACX_CIRCUIT_COMPOSITE_INITIALIZE CodecR_EvtCircuitCompositeInitialize;

NTSTATUS
CodecR_EvtCircuitCompositeInitialize(
    _In_ WDFDEVICE      Device,
    _In_ ACXCIRCUIT     Circuit,
    _In_ ACXOBJECTBAG   CompositeProperties
    )
{
    PAGED_CODE();

    NTSTATUS status = STATUS_SUCCESS;

    UNREFERENCED_PARAMETER(Device);
    UNREFERENCED_PARAMETER(Circuit);

    ASSERT(CompositeProperties);

    DECLARE_CONST_ACXOBJECTBAG_SYSTEM_PROPERTY_NAME(UniqueID);
    GUID uniqueId = {0};
    status = AcxObjectBagRetrieveGuid(CompositeProperties, &UniqueID, &uniqueId);

    // ...

    return status;
}

Requisitos acx

Versão mínima do ACX: 1.0

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

Requisitos

   
Cabeçalho acxcircuit.h

Confira também