Função KsPinGetConnectedPinDeviceObject (ks.h)

  • Artigo

A função KsPinGetConnectedPinDeviceObject retorna o objeto de dispositivo na parte superior da pilha do dispositivo correspondente ao pino do coletor anexado ao pin de origem.

Sintaxe

KSDDKAPI PDEVICE_OBJECT KsPinGetConnectedPinDeviceObject(
  [in] PKSPIN Pin
);

Parâmetros

[in] Pin

Um ponteiro para uma estrutura KSPIN que é o pino de origem para o qual obter o objeto de dispositivo do pino do coletor conectado.

Retornar valor

Se Pin for um pino de origem, KsPinGetConnectedPinDeviceObject retornará um ponteiro para a estrutura DEVICE_OBJECT na parte superior da pilha do dispositivo na qual reside o pino do coletor. Caso contrário, retornará NULL.

Comentários

O objeto de dispositivo retornado não é necessariamente o FDO (objeto de dispositivo funcional) para o dispositivo no qual o coletor reside, pois pode haver um driver de filtro de nível superior. No entanto, é o objeto de dispositivo para o qual as IOCTLs destinadas ao pino do coletor são enviadas.

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

Confira também

KsGetDeviceForDeviceObject