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.
Valor de retorno
KsGetParent retorna o pai do objeto como um PVOID. Os chamadores devem converter manualmente esse valor retornado para qualquer que seja o tipo do pai de Object.
Observações
Para obter uma representação gráfica das relações pai/filho do AVStream, consulte o diagrama em 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, consulte Mutexes no AVStream.
Os minidrivers raramente usam essa função diretamente. Os chamadores de KsGetParent devem executar manualmente typecasts de e para PVOID. Há várias versões embutidas que fazem a conversão para você: KsFilterFactoryGetParentDevice, KsFilterGetParentFilterFactorye KsPinGetParentFilter.
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
KsFilterFactoryGetParentDevice