Compartir a través de


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

Consulte también

Coinitialize

IRP_MJ_CREATE

KSDATAFORMAT

KSPIN_CONNECT

KsCreatePin