Função KsGetFirstChild (ks.h)

A função KsGetFirstChild retorna o primeiro objeto filho AVStream de Object.

Sintaxe

KSDDKAPI PVOID KsGetFirstChild(
  [in] PVOID Object
);

Parâmetros

[in] Object

O objeto para o qual localizar o primeiro objeto filho AVStream.

Retornar valor

KsGetFirstChild retorna o primeiro objeto filho AVStream de Object. Se nenhum objeto filho existir, ele retornará NULL.

Comentários

Para ver a organização hierárquica de objetos AVStream, consulte Hierarquia de Objetos AVStream.

Os minidrivers raramente chamam essa função diretamente. Aqueles que fazem devem executar manualmente typecasts de e para PVOID. Há várias funções que são chamadas embutidas para KsGetFirstChild e executam typecasts para você: KsDeviceGetFirstChildFilterFactory e KsFilterFactoryGetFirstChildFilter. Observe que a hierarquia de objetos só é garantida estável enquanto o mutex apropriado é mantido, nesse caso, o mutex do dispositivo. Para obter mais informações, confira Mutexes no AVStream.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Microsoft Windows XP e em sistemas operacionais posteriores e no DirectX 8.0 e versões posteriores do DirectX.
Plataforma de Destino Universal
Cabeçalho ks.h (inclua Ks.h)
Biblioteca Ks.lib
IRQL PASSIVE_LEVEL

Confira também

KsDeviceGetFirstChildFilterFactory

KsFilterFactoryGetFirstChildFilter

KsFilterGetFirstChildPin

KsGetParent