KsValidateConnectRequest-Funktion (ks.h)

Artikel
02/07/2025

Die KsValidateConnectRequest-Funktion überprüft eine Verbindungsanforderung und gibt einen Zeiger auf die Verbindungsstruktur zurück, die der Anforderung zugeordnet ist.

Diese Funktion kann nur bei PASSIVE_LEVEL aufgerufen werden.

Syntax

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

Parameter

[in] Irp

Zeiger auf einen IRP, der die Verbindungsanforderung angibt.

[in] DescriptorsCount

Gibt die Anzahl der übergebenen Pindeskriptoren an.

[in] Descriptor

Gibt einen Zeiger auf die Liste der KSPIN_DESCRIPTOR Strukturen an.

[out] Connect

Gibt eine Position an, an der ein Zeiger auf den KSPIN_CONNECT Zeiger platziert werden soll, der an die Erstellungsanforderung übergeben wird. Wenn KsValidateConnectRequest Erfolg zurückgibt, enthält Connect+1 einen Zeiger auf das KSDATAFORMAT, mit dem der Pin geöffnet wurde.

Rückgabewert

Die KsValidateConnectRequest--Funktion gibt STATUS_SUCCESS zurück oder gibt einen Fehler zurück.

Bemerkungen

Die KsValidateConnectRequest--Funktion verarbeitet grundlegende Verbindungsstrukturzugriffsausnahmen und überprüft die Kommunikationsanforderungen, das Medium, das Protokoll und das grundlegende Datenformat. Die für das übergebene Datenformat durchgeführte Überprüfung basiert auf der Datenbereichsliste für die angegebene Pin, für die eine Pininstanz erstellt werden soll. Die Überprüfung ist in drei Instanzen erfolgreich: Wenn es sich bei einem Bereichshauptformat um einen Wildcard handelt, stimmt das Hauptformat des Bereichs überein, und das Unterformat des Bereichs ist ein Wildcard oder das Hauptformat des Bereichs, Das Bereichsunterformat und der Bereichsbezeichner stimmen alle überein.

Der Puffer wird eine Kopie des ursprünglichen Eingabepuffers übergeben, wenn sich der Absender nicht im Kernelmodus befand und daher sicher ist.

Anforderungen

Anforderung	Wert
Zielplattform-	Universal
Header-	ks.h (enthalten Ks.h)
Library	Ks.lib

Freigeben über