Função KsRegisterFilterWithNoKSPins (ks.h)
A função KsRegisterFilterWithNoKSPins registra com filtros DirectShow que não têm pinos de streaming de kernel e, portanto, não são transmitidos no modo kernel.
Sintaxe
KSDDKAPI NTSTATUS KsRegisterFilterWithNoKSPins(
[in] PDEVICE_OBJECT DeviceObject,
[in] const GUID *InterfaceClassGUID,
[in] ULONG PinCount,
[in] BOOL *PinDirection,
[in] KSPIN_MEDIUM *MediumList,
[in, optional] GUID *CategoryList
);
Parâmetros
[in] DeviceObject
Um ponteiro para uma estrutura de DEVICE_OBJECT correspondente ao dispositivo ao qual registrar o filtro.
[in] InterfaceClassGUID
Um ponteiro para o GUID que representa a classe a ser registrada. Por exemplo, isso apontaria para KSCATEGORY_TVTUNER para um filtro do TvTuner.
[in] PinCount
A contagem do número de pinos no filtro.
[in] PinDirection
Um ponteiro para o primeiro elemento de uma matriz de valores boolianos que indica a direção do pino para cada pino no filtro. Os pinos de saída são VERDADEIRO; os pinos de entrada são FALSE. Essa matriz deve ter PinCount de comprimento.
[in] MediumList
Um ponteiro para o primeiro elemento de uma matriz de estruturas de KSPIN_MEDIUM definindo os meios para cada pino no filtro. Essa matriz deve ter PinCount de comprimento.
[in, optional] CategoryList
Um ponteiro para o primeiro elemento de uma matriz de GUIDs definindo as categorias para cada pino no filtro. Se esse parâmetro estiver presente, ele deverá ser pinCount de comprimento.
Valor de retorno
Retorna êxito ou falha ao criar a chave FilterData no registro.
Observações
Use KsRegisterFilterWithNoKSPins para registrar tvtuners, barras cruzadas e componentes semelhantes. KsRegisterFilterWithNoKSPins cria uma nova chave do Registro, FilterData, que contém os meios e, opcionalmente, as categorias, para cada pino no filtro.
Essa função é usada apenas para registrar filtros que não têm pinos de kernel correspondentes. Se bem-sucedido, KsRegisterFilterWithNoKSPins cria uma chave no registro que pode ser usada pelo DirectShow.
Se estiver escrevendo um minidriver BDA, considere usar KsFilterFactoryUpdateCacheData em vez dessa rotina. Consulte detalhes na página de referência para KsFilterFactoryUpdateCacheData.
Para obter mais informações, consulte de descritores AVStream e inicializando um minidriver AVStream.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível no Microsoft Windows XP e em sistemas operacionais posteriores e no DirectX 8.0 e versões posteriores do DirectX. |
| da Plataforma de Destino | Universal |
| cabeçalho | ks.h (incluir Ks.h) |
| biblioteca | Ks.lib |
| IRQL | PASSIVE_LEVEL |