Função KsGetDevice (ks.h)

Artigo
02/29/2024

A função KsGetDevice retorna a estrutura do dispositivo AVStream à qual Object pertence.

Sintaxe

KSDDKAPI PKSDEVICE KsGetDevice(
  [in] PVOID Object
);

Parâmetros

[in] Object

O objeto a ser consultado para o dispositivo ao qual ele pertence.

Retornar valor

KsGetDevice retorna um ponteiro para uma estrutura KSDEVICE que é o dispositivo AVStream ao qual Object pertence.

Comentários

O objeto deve ser um dos seguintes: PKSPIN, PKSFILTER ou PKSFILTERFACTORY. Os chamadores devem executar o typecasting apropriado para PVOID.

Os minidrivers normalmente não chamam essa função diretamente. Há várias funções que executam chamadas embutidas para KsGetDevice e que executam o typecasting automaticamente: KsFilterFactoryGetDevice, KsFilterGetDevice e KsPinGetDevice.

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