Función KsCreatePin (ks.h)
La función KsCreatePin pasa una solicitud de conexión a un dispositivo, creando una instancia de pin. Esta función solo se puede llamar 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 seguirse en memoria por una estructura de datos KSDATAFORMAT , 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_WRITE y, 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, se puede devolver este código de error de Win32 (de Winerror.h):
Comentarios
La rutina envía una solicitud de 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 | Value |
|---|---|
| Plataforma de destino | Universal |
| Encabezado | ks.h (incluya Ks.h) |
| Library | Ks.lib |