Función KsCreatePin2 (ks.h)

2025-02-07

Pasa una solicitud de conexión a un dispositivo, creando una instancia de anclaje.

Se admite a partir de Windows 8.

Sintaxis

KSDDKAPI HRESULT KsCreatePin2(
  [in]  HANDLE         FilterHandle,
  [in]  PKSPIN_CONNECT Connect,
  [in]  ACCESS_MASK    DesiredAccess,
  [out] PHANDLE        ConnectionHandle
);

Parámetros

[in] FilterHandle

Especifica el identificador del filtro que inicia la solicitud de creación y dónde se producirá la conexión.

[in] Connect

Puntero a una estructura de KSPIN_CONNECT que contiene parámetros para la conexión solicitada. Esto debe ir seguido de la memoria por un KSDATAFORMAT estructura de datos, que describe el formato de datos solicitado para la conexión.

[in] DesiredAccess

Especifica el acceso deseado al pin. Esto suele ser GENERIC_READ o GENERIC_WRITE. Para los datos que fluyen al pin, este valor debe establecerse en GENERIC_WRITEy para los datos que fluyen fuera del pin, se debe establecer en GENERIC_READ independientemente del método de comunicación.

[out] ConnectionHandle

Especifica el identificador de conexión pasado. La rutina rellena esto con un identificador para el objeto de archivo de la conexión creada. A continuación, este valor se puede usar para desconectar con la función CloseHandle.

Valor devuelto

Devuelve NOERROR si se ejecuta correctamente; de lo contrario, devuelve un código de error.

Observaciones

Se trata de una nueva versión de la función KsCreatePin y usa el agente de dispositivo para crear el identificador para el objeto de streaming del kernel. Además, se debe llamar a la función Component Object Model (COM) CoInitialize antes de llamar a esta función.

La rutina envía una solicitud IRP_MJ_CREATE al controlador. El controlador acepta la solicitud solo si la interfaz, el medio y el formato de datos son compatibles.

Si Connect:> PinToHandle es null, KsCreatePin2 crea un pin que el autor de la llamada puede usar para enviar solicitudes al controlador de streaming especificado en Connect->FilterHandle. Connect:>PinId determina el tipo de patilla que se va a crear.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 8
servidor mínimo admitido	Windows Server 2012
de la plataforma de destino de	Universal
encabezado de	ks.h (incluya Ks.h)
irQL	PASSIVE_LEVEL

Consulte también

KSDATAFORMAT