Método IKsPin::KsGetCurrentCommunication (ksproxy.h)
O método KsGetCurrentCommunication recupera a direção da comunicação atual, a interface e a média de um pino.
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 tipo KSPIN_COMMUNICATION 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 pino. |
| 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 pino.
[out, optional] Medium
Ponteiro para uma variável que recebe uma estrutura KSPIN_MEDIUM que descreve o meio atual para um pino.
Valor de retorno
Retorna NOERROR se bem-sucedido; caso contrário, retorna um código de erro.
Observações
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 a média 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 |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | ksproxy.h (inclua Ksproxy.h) |