Função KsGetParent (ks.h)
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 |
Confira também
KsFilterFactoryGetParentDevice