Función KsCreatePin (ks.h)
La función KsCreatePin pasa una solicitud de conexión a un dispositivo y crea una instancia de anclaje. Solo se puede llamar a esta función en PASSIVE_LEVEL para clientes en modo kernel.
Sintaxis
KSDDKAPI NTSTATUS KsCreatePin(
[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
La función KsCreatePin devuelve STATUS_SUCCESS si la conexión se realizó correctamente o devuelve un error si se produjo un error en la conexión. Además, este código de error win32 (de Winerror.h) se puede devolver:
Observaciones
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, KsCreatePin 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 |
|---|---|
| de la plataforma de destino de | Universal |
| encabezado de | ks.h (incluya Ks.h) |
| biblioteca de | Ks.lib |