Metodo IConnector::GetType (devicetopology.h)

  • Articolo

Il metodo GetType ottiene il tipo di questo connettore.

Sintassi

HRESULT GetType(
  [out] ConnectorType *pType
);

Parametri

[out] pType

Puntatore a una variabile in cui il metodo scrive il tipo di connettore. Il tipo di connettore è una delle costanti di enumerazione ConnectorType seguenti:

Unknown_Connector

Physical_Internal

Physical_External

Software_IO

Software_Fixed

Rete

Valore restituito

Se il metodo ha esito positivo, viene restituito S_OK. Se ha esito negativo, i codici restituiti possibili includono, ma non sono limitati a, i valori visualizzati nella tabella seguente.

Codice restituito Descrizione
E_POINTER
 Puntatore pType è NULL.

Commenti

Un connettore corrisponde a una terminologia "pin" nella terminologia del kernel streaming (KS). Il mapping dei pin KS ai connettori è il seguente:

  • Se il tipo di comunicazione del pin KS è KSPIN_COMMUNICATION_SINK, KSPIN_COMMUNICATION_SOURCE o KSPIN_COMMUNICATION_BOTH, il tipo di connettore è Software_IO.
  • In caso contrario, se il pin fa parte di una connessione fisica tra due filtri KS (dispositivi) nella stessa scheda audio o in schede audio diverse, il tipo di connettore è Software_Fixed.
  • In caso contrario, se la categoria del pin KS è KSNODETYPE_SPEAKER, KSNODETYPE_MICROPHONE, KSNODETYPE_LINE_CONNECTOR o KSNODETYPE_SPDIF_INTERFACE, il tipo di connettore è Physical_External.
  • In caso contrario, per un pin che non soddisfa alcun criterio precedente, il tipo di connettore è Physical_Internal.
Per altre informazioni sui pin KS, vedere la documentazione di Windows DDK.

Per un esempio di codice che chiama il metodo GetType , vedere l'implementazione della funzione SelectCaptureDevice in Topologie dispositivo.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione devicetopology.h

Vedi anche

Interfaccia IConnector