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 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.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | bdasup.h (inclua Bdasup.h) |
| Biblioteca | Bdasup.lib |
| IRQL | PASSIVE_LEVEL |