Método IConnector::GetType (devicetopology.h)

O método GetType obtém o tipo desse conector.

Sintaxe

HRESULT GetType(
  [out] ConnectorType *pType
);

Parâmetros

[out] pType

Ponteiro para uma variável na qual o método grava o tipo de conector. O tipo de conector é uma das seguintes constantes de enumeração ConnectorType :

Unknown_Connector

Physical_Internal

Physical_External

Software_IO

Software_Fixed

Rede

Retornar valor

Se o método for bem-sucedido, retornará S_OK. Se falhar, os códigos de retorno possíveis incluem, mas não se limitam a, os valores mostrados na tabela a seguir.

Código de retorno Descrição
E_POINTER
O pType do ponteiro é NULL.

Comentários

Um conector corresponde a um "pin" na terminologia KS (streaming de kernel). O mapeamento de pinos KS para conectores é o seguinte:

  • Se o tipo de comunicação de pino KS for KSPIN_COMMUNICATION_SINK, KSPIN_COMMUNICATION_SOURCE ou KSPIN_COMMUNICATION_BOTH, o tipo de conector será Software_IO.
  • Caso contrário, se o pino fizer parte de uma conexão física entre dois filtros KS (dispositivos) no mesmo adaptador de áudio ou em adaptadores de áudio diferentes, o tipo de conector será Software_Fixed.
  • Caso contrário, se a categoria de pino KS for KSNODETYPE_SPEAKER, KSNODETYPE_MICROPHONE, KSNODETYPE_LINE_CONNECTOR ou KSNODETYPE_SPDIF_INTERFACE, o tipo de conector será Physical_External.
  • Caso contrário, para um pin que não atende a nenhum dos critérios anteriores, o tipo de conector é Physical_Internal.
Para obter mais informações sobre pinos KS, consulte a documentação do DDK do Windows.

Para obter um exemplo de código que chama o método GetType , consulte a implementação da função SelectCaptureDevice em Topologias de Dispositivo.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho devicetopology.h

Confira também

IConnector Interface