Fonction SpbRequestGetParameters (spbcx.h)

Article
02/29/2024

La méthode SpbRequestGetParameters récupère un ensemble de valeurs de paramètres spécifiques À SPB à partir d’une requête d’E/S.

Syntaxe

void SpbRequestGetParameters(
  [in]  SPBREQUEST             SpbRequest,
  [out] SPB_REQUEST_PARAMETERS *Parameters
);

Paramètres

[in] SpbRequest

Un handle SPBREQUEST pour la demande d’E/S. Le pilote du contrôleur SPB a déjà reçu ce handle via l’une de ses fonctions de rappel d’événements inscrites.

[out] Parameters

Pointeur vers une structure de SPB_REQUEST_PARAMETERS allouée par l’appelant dans laquelle la méthode écrit les valeurs de paramètre spécifiques À SPB à partir de la demande d’E/S. L’appelant doit avoir précédemment initialisé cette structure en appelant la fonction SPB_REQUEST_PARAMETERS_INIT .

Valeur de retour

None

Remarques

SpbRequestGetParameters est similaire à la méthode WdfRequestGetParameters , mais ne récupère que des informations spécifiques à SPB. Votre pilote de contrôleur SPB peut appeler SpbRequestGetParameters pour récupérer des informations spécifiques À SPB à partir des demandes d’E/S qu’il reçoit de l’extension SPB Framework (SpbCx). Le pilote de contrôleur SPB peut appeler WdfRequestGetParameters pour récupérer les paramètres de requête génériques des demandes d’E/S qu’il reçoit.

Exemples

L’exemple de code suivant montre comment utiliser SpbRequestGetParameters pour récupérer les paramètres spécifiques de SPB à partir d’une demande d’E/S. La variable spbRequest contient un handle SPBREQUEST pour la requête d’E/S.

SPB_REQUEST_PARAMETERS parameters;

SPB_REQUEST_PARAMETERS_INIT(&parameters);

SpbRequestGetParameters(spbRequest, &parameters);

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible à partir de Windows 8.
Plateforme cible	Universal
En-tête	spbcx.h
Bibliothèque	Spbcxstubs.lib
IRQL	<= DISPATCH_LEVEL