Função BdaPropertyGetControllingPinId (bdasup.h)
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 de 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ó.
Valor de retorno
Retorna STATUS_SUCCESS ou um código de erro apropriado.
Observações
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 do BDA pode definir tabelas de expedição e automação de filtro para que esses minidrivers enviem diretamente a função BdaPropertyGetControllingPinId, sem interceptar essa solicitação usando um manipulador de obtenção interno (KStrGetPropertyHandler). Consulte Definindo tabelas de automação e determinando de topologia de dispositivo BDA para obter mais informações.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | bdasup.h (inclua Bdasup.h) |
| biblioteca | Bdasup.lib |
| IRQL | PASSIVE_LEVEL |