IKsPin::KsGetCurrentCommunication method (ksproxy.h)

Artikel
02/26/2024

Metode KsGetCurrentCommunication mengambil arah komunikasi, antarmuka, dan media pin saat ini.

Sintaks

HRESULT KsGetCurrentCommunication(
  [out, optional] KSPIN_COMMUNICATION *Communication,
  [out, optional] KSPIN_INTERFACE     *Interface,
  [out, optional] KSPIN_MEDIUM        *Medium
);

Parameter

[out, optional] Communication

Penunjuk ke variabel yang menerima salah satu nilai berikut dari jenis KSPIN_COMMUNICATION enumerasi yang menjelaskan arah komunikasi saat ini untuk pin:

Nilai	Deskripsi
KSPIN_COMMUNICATION_NONE	Pabrik pin tidak membuat instans pin apa pun.
KSPIN_COMMUNICATION_SINK	Pabrik pin membuat instans pin sink IRP. Pin tersebut hanya dapat dihubungkan ke pin sumber IRP.
KSPIN_COMMUNICATION_SOURCE	Pabrik pin membuat instans pin sumber IRP. Pin tersebut hanya dapat dihubungkan ke pin sink IRP.
KSPIN_COMMUNICATION_BOTH	Pabrik pin membuat instans pin yang merupakan sink IRP dan sumber IRP.
KSPIN_COMMUNICATION_BRIDGE	Pin tidak dapat terhubung ke pin lain, tetapi instans dapat dibuat di atasnya untuk menerima permintaan I/O non-KS.

[out, optional] Interface

Penunjuk ke variabel yang menerima struktur KSPIN_INTERFACE yang menjelaskan antarmuka saat ini untuk pin.

[out, optional] Medium

Penunjuk ke variabel yang menerima struktur KSPIN_MEDIUM yang menjelaskan media saat ini untuk pin.

Nilai kembali

Mengembalikan NOERROR jika berhasil; jika tidak, mengembalikan kode kesalahan.

Keterangan

Pin sumber mengirim IRP ke pin sink. Jangan membingungkan arah komunikasi dengan arah aliran data. (Lihat KSPROPERTY_PIN_DATAFLOW.) Pin sumber dapat membaca atau menulis data, dan pin sink mungkin memiliki data yang dibaca atau ditulis darinya.

Arah komunikasi, antarmuka, dan media pin saat ini adalah subset dari yang tersedia untuk pin, dan dipilih saat handel pin dibuat.