Método IKsPin::KsGetCurrentCommunication (ksproxy.h)
O método KsGetCurrentCommunication recupera a direção de comunicação atual, a interface e o meio de um pin.
Sintaxe
HRESULT KsGetCurrentCommunication(
[out, optional] KSPIN_COMMUNICATION *Communication,
[out, optional] KSPIN_INTERFACE *Interface,
[out, optional] KSPIN_MEDIUM *Medium
);
Parâmetros
[out, optional] Communication
Ponteiro para uma variável que recebe um dos seguintes valores do KSPIN_COMMUNICATION tipo enumerado que descreve a direção de comunicação atual para um pin:
| Valor | Descrição |
|---|---|
| KSPIN_COMMUNICATION_NONE | A fábrica de pinos não cria instâncias de fixação. |
| KSPIN_COMMUNICATION_SINK | A fábrica de pinos cria instâncias de pinos de coletor IRP. Esses pinos só podem ser conectados a pinos de origem IRP. |
| KSPIN_COMMUNICATION_SOURCE | A fábrica de pinos cria instâncias de pinos de origem IRP. Esses pinos só podem ser conectados a pinos de coletor IRP. |
| KSPIN_COMMUNICATION_BOTH | A fábrica de pinos cria instâncias de pinos que são coletores IRP e fontes IRP. |
| KSPIN_COMMUNICATION_BRIDGE | O pino não pode se conectar a outros pinos, mas as instâncias podem ser criadas nele para receber solicitações de E/S não KS. |
[out, optional] Interface
Ponteiro para uma variável que recebe uma estrutura KSPIN_INTERFACE que descreve a interface atual de um pin.
[out, optional] Medium
Ponteiro para uma variável que recebe uma estrutura KSPIN_MEDIUM que descreve o meio atual para um pin.
Retornar valor
Retorna NOERROR se tiver êxito; caso contrário, retorna um código de erro.
Comentários
Os pinos de origem enviam IRPs para pinos de coletor. Não confunda a direção da comunicação com a direção do fluxo de dados. (Consulte KSPROPERTY_PIN_DATAFLOW.) Um pino de origem pode ler ou gravar dados, e um pino de coletor pode ter dados lidos ou gravados nele.
A direção de comunicação atual, a interface e o meio de um pino são um subconjunto daqueles disponíveis para o pino e são selecionados quando o identificador de pino é criado.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | ksproxy.h (inclua Ksproxy.h) |