Função KsPinGetConnectedPinDeviceObject (ks.h)
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 |