Función BdaMethodCreatePin (bdasup.h)

Artículo
02/22/2024

La función BdaMethodCreatePin crea un generador de patillas.

Sintaxis

NTSTATUS BdaMethodCreatePin(
  [in]            PIRP      pIrp,
  [in]            PKSMETHOD pKSMethod,
  [out, optional] PULONG    pulPinFactoryID
);

Parámetros

[in] pIrp

Apunta al IRP de la solicitud para crear un generador de patillas. El minidriver BDA recibe este IRP con la solicitud KSMETHOD_BDA_CREATE_PIN_FACTORY .

[in] pKSMethod

Apunta a una estructura KSMETHOD que describe el método y el tipo de solicitud de una solicitud de método.

[out, optional] pulPinFactoryID

Apunta a una variable que recibe el identificador del generador de patillas.

Valor devuelto

Devuelve STATUS_SUCCESS o un código de error adecuado.

Comentarios

Un minidriver BDA llama a la función BdaMethodCreatePin para crear un generador de patillas después de que el minidriver reciba una solicitud KSMETHOD_BDA_CREATE_PIN_FACTORY del método KSMETHODSETID_BdaDeviceConfiguration establecido 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 BdaMethodCreatePin directamente, sin interceptar esta solicitud mediante un método interno (KStrMethodHandler). Consulte Definición de tablas de automatización y Configuración de un filtro BDA para obtener más información.

Si un minidriver BDA debe crear un pin sin depender del proveedor de red, el minidriver BDA debe llamar a la función BdaCreatePin .