KsValidateConnectRequest, fonction (ks.h)

La fonction KsValidateConnectRequest valide une demande de connexion et retourne un pointeur vers la structure de connexion associée à la requête.

Cette fonction ne peut être appelée qu’à PASSIVE_LEVEL.

Syntaxe

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

Paramètres

[in] Irp

Pointeur vers un IRP spécifiant la demande de connexion.

[in] DescriptorsCount

Spécifie le nombre de descripteurs d’épingle passés.

[in] Descriptor

Spécifie un pointeur vers la liste des structures KSPIN_DESCRIPTOR .

[out] Connect

Spécifie un emplacement dans lequel placer un pointeur vers le pointeur KSPIN_CONNECT passé à la demande de création. Si KsValidateConnectRequest retourne success, Connect+1 contient un pointeur vers le KSDATAFORMAT avec lequel l’épingle a été ouverte.

Valeur retournée

La fonction KsValidateConnectRequest retourne STATUS_SUCCESS si elle réussit, ou renvoie une erreur.

Remarques

La fonction KsValidateConnectRequest gère les exceptions d’accès à la structure de connexion de base et valide les exigences de communication, le support, le protocole et le format de données de base. La validation effectuée sur le format de données passé est basée sur la liste de plages de données pour l’épingle spécifiée sur laquelle un instance d’épingle doit être créé. La validation réussit dans trois instances : si un format principal de plage est un caractère générique, le format principal de plage correspond et le sous-format de plage est un caractère générique, ou le format principal de plage, le sous-format de plage et le spécificateur de plage correspondent tous.

La mémoire tampon est transmise une copie de la mémoire tampon d’entrée d’origine, si l’initiateur n’était pas en mode noyau, et est donc accessible en toute sécurité.

Configuration requise

Condition requise	Valeur
Plateforme cible	Universal
En-tête	ks.h (inclure Ks.h)
Bibliothèque	Ks.lib