共用方式為

KsValidateConnectRequest 函式 (ks.h)

  • 發行項

KsValidateConnectRequest 函式會驗證連接要求，並傳回與要求相關聯之連接結構的指標。

此函式只能在PASSIVE_LEVEL呼叫。

語法

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

參數

[in] Irp

指定連接要求的 IRP 指標。

[in] DescriptorsCount

指定傳遞的針腳描述項數目。

[in] Descriptor

指定 KSPIN_DESCRIPTOR 結構的指標。

[out] Connect

指定要將指標置於傳遞至建立要求 之KSPIN_CONNECT 指標的位置。 如果 KsValidateConnectRequest 傳回成功，Connect+1 將會包含已開啟針腳的 KSDATAFORMAT 指標。

傳回值

如果成功， KsValidateConnectRequest 函式會傳回STATUS_SUCCESS，否則會傳回錯誤。

備註

KsValidateConnectRequest 函式會處理基本連線結構存取例外狀況，並驗證通訊需求、中型、通訊協定和基本數據格式。 在傳遞的數據格式上執行的驗證是以要建立釘選實例之指定針腳的數據範圍清單為基礎。 驗證在三個實例中成功：如果範圍主要格式是通配符，範圍主要格式會相符，而範圍子格式為通配符，或範圍主要格式、範圍子格式，以及範圍規範全相符。

如果原始輸入緩衝區不在核心模式中，則緩衝區會傳遞原始輸入緩衝區的複本，因此可以安全地存取。

規格需求

需求 值
目標平台 Universal
標頭 ks.h (包含 Ks.h)
程式庫 Ks.lib