Fungsi KsValidateConnectRequest (ks.h)

Fungsi KsValidateConnectRequest memvalidasi permintaan koneksi dan mengembalikan penunjuk ke struktur koneksi yang terkait dengan permintaan.

Fungsi ini hanya dapat dipanggil pada PASSIVE_LEVEL.

Sintaks

KSDDKAPI NTSTATUS KsValidateConnectRequest(
  [in]  PIRP                   Irp,
  [in]  ULONG                  DescriptorsCount,
  [in]  const KSPIN_DESCRIPTOR *Descriptor,
  [out] PKSPIN_CONNECT         *Connect
);

Parameter

[in] Irp

Penunjuk ke IRP yang menentukan permintaan koneksi.

[in] DescriptorsCount

Menentukan jumlah deskriptor pin yang diteruskan.

[in] Descriptor

Menentukan penunjuk ke daftar struktur KSPIN_DESCRIPTOR .

[out] Connect

Menentukan lokasi untuk menempatkan penunjuk ke penunjuk KSPIN_CONNECT yang diteruskan ke permintaan buat. Jika KsValidateConnectRequest berhasil, maka Connect+1 akan berisi penunjuk ke KSDATAFORMAT tempat pin dibuka.

Nilai kembali

Fungsi KsValidateConnectRequest mengembalikan STATUS_SUCCESS jika berhasil, atau mengembalikan kesalahan.

Keterangan

Fungsi KsValidateConnectRequest menangani pengecualian akses struktur koneksi dasar dan memvalidasi persyaratan komunikasi, medium, protokol, dan format data dasar. Validasi yang dilakukan pada format data yang diteruskan didasarkan pada daftar rentang data untuk pin yang ditentukan tempat instans pin akan dibuat. Validasi berhasil dalam tiga instans: jika format utama rentang adalah kartubebas, format utama rentang cocok dan subformat rentang adalah kartubebas, atau format utama rentang, subformat rentang, dan penentu rentang semuanya cocok.

Buffer diteruskan salinan buffer input asli, jika pencacah tidak dalam mode kernel, dan karenanya aman untuk diakses.

Persyaratan

Persyaratan	Nilai
Target Platform	Universal
Header	ks.h (termasuk Ks.h)
Pustaka	Ks.lib