Função KsCreatePin2 (ks.h)
Passa uma solicitação de conexão para um dispositivo, criando uma instância de pin.
Com suporte a partir de Windows 8.
Sintaxe
KSDDKAPI HRESULT KsCreatePin2(
[in] HANDLE FilterHandle,
[in] PKSPIN_CONNECT Connect,
[in] ACCESS_MASK DesiredAccess,
[out] PHANDLE ConnectionHandle
);
Parâmetros
[in] FilterHandle
Especifica o identificador do filtro que inicia a solicitação de criação e onde a conexão ocorrerá.
[in] Connect
Ponteiro para uma estrutura KSPIN_CONNECT que contém parâmetros para a conexão solicitada. Isso deve ser seguido na memória por uma estrutura de dados KSDATAFORMAT , descrevendo o formato de dados solicitado para a conexão.
[in] DesiredAccess
Especifica o acesso desejado ao pino. Normalmente, isso é GENERIC_READ ou GENERIC_WRITE. Para dados que fluem para o pino, esse valor deve ser definido como GENERIC_WRITE e, para dados que fluem para fora do pino, isso deve ser definido como GENERIC_READ independentemente do método de comunicação.
[out] ConnectionHandle
Especifica o identificador de conexão passado. A rotina preenche isso com um identificador para o objeto de arquivo da conexão criada. Esse valor pode ser usado para se desconectar com a função CloseHandle .
Retornar valor
Retorna NOERROR se tiver êxito; caso contrário, retorna um código de erro.
Comentários
Essa é uma nova versão da função KsCreatePin e usa o agente de dispositivo para criar o identificador para o objeto de streaming do kernel. Além disso, a função CoInitialize do COM (Component Object Model) deve ser chamada antes que essa função seja chamada.
A rotina envia uma solicitação de IRP_MJ_CREATE para o driver. O driver aceita a solicitação somente se a interface, o meio e o formato de dados forem compatíveis.
Se Connect-PinToHandle> for NULL, KsCreatePin2 criará um pin que o chamador pode usar para enviar solicitações para o driver de streaming especificado em Connect-FilterHandle>. Connect-PinId> determina o tipo de pin a ser criado.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 8 |
| Servidor mínimo com suporte | Windows Server 2012 |
| Plataforma de Destino | Universal |
| Cabeçalho | ks.h (inclua Ks.h) |
| IRQL | PASSIVE_LEVEL |