Función BdaPropertyGetControllingPinId (bdasup.h)
La función BdaPropertyGetControllingPinId recupera el identificador de un pin en el que controlar las propiedades, los métodos y los eventos de un nodo específico.
Sintaxis
NTSTATUS BdaPropertyGetControllingPinId(
[in] PIRP Irp,
[in] PKSP_BDA_NODE_PIN Property,
[out, optional] PULONG pulControllingPinId
);
Parámetros
[in] Irp
Apunta al IRP de la solicitud para recuperar la patilla de control de un nodo. El minidriver BDA recibe este IRP con la solicitud KSPROPERTY_BDA_CONTROLLING_PIN_ID.
[in] Property
Apunta a una estructura de KSP_BDA_NODE_PIN que describe la propiedad y el tipo de solicitud de la solicitud de propiedad para recuperar la patilla de control de un nodo.
[out, optional] pulControllingPinId
Apunta a una variable que recibe el identificador de la patilla de control de un nodo.
Valor devuelto
Devuelve STATUS_SUCCESS o un código de error adecuado.
Observaciones
Un minidriver BDA llama a la función BdaPropertyGetControllingPinId para recuperar el identificador del pin de control de un nodo después de que el minidriver reciba una solicitud KSPROPERTY_BDA_CONTROLLING_PIN_ID de la propiedad KSPROPSETID_BdaTopology establecida desde el proveedor de red. La mayoría de los minidrivers de BDA pueden definir tablas de distribución y automatización de filtros para que esos minidrivers envíen la función BdaPropertyGetControllingPinId directamente, sin interceptar esta solicitud mediante un controlador get interno (KStrGetPropertyHandler). Consulte Definición de tablas de automatización y determinar la topología de dispositivos BDA para obtener más información.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Escritorio |
| encabezado de | bdasup.h (incluya Bdasup.h) |
| biblioteca de | Bdasup.lib |
| irQL | PASSIVE_LEVEL |