Share via

Função AcxFactoryCircuitInitAssignComponentUri (acxcircuit.h)

  • Artigo

A função AcxFactoryCircuitInitAssignComponentUri atribui uma cadeia de caracteres de URI como identificador para o ACXFACTORYCIRCUIT.

Sintaxe

NTSTATUS AcxFactoryCircuitInitAssignComponentUri(
  PACXFACTORYCIRCUIT_INIT FactoryInit,
  PCUNICODE_STRING        ComponentUri
);

Parâmetros

FactoryInit

Uma estrutura ACXFACTORYCIRCUIT_INIT usada para inicialização de fábrica de circuitos. Essa é uma estrutura opaca usada para armazenar informações de inicialização de fábrica do Circuito ACX e associar a fábrica a um dispositivo WDF.

Use a função AcxFactoryCircuitInitAllocate para inicializar a estrutura ACXFACTORYCIRCUIT_INIT.

ComponentUri

Uma cadeia de caracteres unicode que descreve o componente.

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

O driver deve inicializar a identidade da fábrica de circuitos definindo seu URI e/ou sua ID (AcxCircuitInitSetComponentId).

Exemplo

O uso de exemplo é mostrado abaixo.

    DECLARE_CONST_UNICODE_STRING(dspFactoryName, L"DspFactoryCircuit");
    DECLARE_CONST_UNICODE_STRING(dspFactoryUri, L"URI_Goes_Here");

    //
    // Get a FactoryCircuitInit structure.
    //
    PACXFACTORYCIRCUIT_INIT factoryInit = NULL;
    factoryInit = AcxFactoryCircuitInitAllocate(Device);

    //
    // Add factory identifiers.
    //
    status = cxFactoryCircuitInitAssignComponentUri(factoryInit, &dspFactoryUri);
    status = AcxFactoryCircuitInitAssignName(factoryInit, &dspFactoryName);

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 acxcircuit.h
IRQL PASSIVE_LEVEL

Confira também