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

Consulte también

IRP_MJ_CREATE

KSDATAFORMAT

KSPIN_CONNECT