Função KsGetParent (ks.h)

Artigo
03/01/2024

A função KsGetParent adquire o pai do objeto fornecido.

Sintaxe

KSDDKAPI PVOID KsGetParent(
  [in] PVOID Object
);

Parâmetros

[in] Object

Um ponteiro para o objeto AVStream para o qual localizar o pai. Deve ser um ponteiro para um dos seguintes tipos: KSDEVICE, KSFILTERFACTORY, KSFILTER ou KSPIN. Os chamadores devem digitar manualmente o objeto em um PVOID.

Retornar valor

KsGetParent retorna o pai de Object como um PVOID. Os chamadores devem converter manualmente esse valor retornado para qualquer que seja o tipo do pai de Object .

Comentários

Para obter uma representação gráfica das relações pai/filho do AVStream, consulte o diagrama na Hierarquia de Objetos AVStream.

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.

Os minidrivers raramente usam essa função diretamente. Os chamadores do KsGetParent devem executar manualmente typecasts de e para PVOID. Há várias versões embutidas que fazem a conversão para você: KsFilterFactoryGetParentDevice, KsFilterGetParentFilterFactory e KsPinGetParentFilter.

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