Função BdaPropertyGetControllingPinId (bdasup.h)

Artigo
02/26/2024

A função BdaPropertyGetControllingPinId recupera o identificador de um pino no qual controlar as propriedades, os métodos e os eventos de um nó específico.

Sintaxe

NTSTATUS BdaPropertyGetControllingPinId(
  [in]            PIRP              Irp,
  [in]            PKSP_BDA_NODE_PIN Property,
  [out, optional] PULONG            pulControllingPinId
);

Parâmetros

[in] Irp

Aponta para o IRP para a solicitação para recuperar o pino de controle de um nó. O minidriver BDA recebe esse IRP com a solicitação KSPROPERTY_BDA_CONTROLLING_PIN_ID .

[in] Property

Aponta para uma estrutura KSP_BDA_NODE_PIN que descreve a propriedade e o tipo de solicitação da solicitação de propriedade para recuperar o pino de controle de um nó.

[out, optional] pulControllingPinId

Aponta para uma variável que recebe o identificador do pino de controle de um nó.

Retornar valor

Retorna STATUS_SUCCESS ou um código de erro apropriado.

Comentários

Um minidriver BDA chama a função BdaPropertyGetControllingPinId para recuperar o identificador do pino de controle de um nó depois que o minidriver recebe uma solicitação KSPROPERTY_BDA_CONTROLLING_PIN_ID do conjunto de propriedades KSPROPSETID_BdaTopology do provedor de rede. A maioria dos minidrivers BDA pode definir tabelas de expedição e automação de filtro para que esses minidrivers enviem a função BdaPropertyGetControllingPinId diretamente, sem interceptar essa solicitação usando um manipulador de get interno (KStrGetPropertyHandler). Consulte Definindo tabelas de automação e determinando a topologia do dispositivo BDA para obter mais informações.