Función KsCreatePin2 (ks.h)
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 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
Devuelve NOERROR si se ejecuta correctamente; de lo contrario, devuelve un código de error.
Comentarios
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 CoInitialize del modelo de objetos componentes (COM) antes de llamar a esta función.
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, 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 pin que se va a crear.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 8 |
| Servidor mínimo compatible | Windows Server 2012 |
| Plataforma de destino | Universal |
| Encabezado | ks.h (incluya Ks.h) |
| IRQL | PASSIVE_LEVEL |