Compartilhar via


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 do AVStream.

Valor de retorno

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

Observações

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 isso devem executar manualmente typecasts de e para PVOID. Há várias funções que são chamadas embutidas para KsGetFirstChild e executar 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, consulte Mutexes no 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

Consulte também

KsDeviceGetFirstChildFilterFactory

KsFilterFactoryGetFirstChildFilter

KsFilterGetFirstChildPin

KsGetParent