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 do 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 create e onde a conexão ocorrerá.
[in] Connect
Ponteiro para uma estrutura de 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_WRITEe, 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.
Valor de retorno
Retorna NOERROR se bem-sucedido; caso contrário, retorna um código de erro.
Observações
Esta é uma nova versão da função KsCreatePin e usa o agente do dispositivo para criar o identificador para o objeto de streaming do kernel. Além disso, a função COM (Component Object Model) CoInitialize deve ser chamada antes que essa função seja chamada.
A rotina envia uma solicitação IRP_MJ_CREATE ao 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 pino que o chamador pode usar para enviar solicitações ao driver de streaming especificado no Connect->FilterHandle. Connect–> PinId determina o tipo de pino a ser criado.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 8 |
| servidor com suporte mínimo | Windows Server 2012 |
| da Plataforma de Destino | Universal |
| cabeçalho | ks.h (incluir Ks.h) |
| IRQL | PASSIVE_LEVEL |