Fonction SpbRequestComplete (spbcx.h)

Article
02/29/2024

La méthode SpbRequestComplete termine une demande d’E/S et fournit une status d’achèvement.

Syntaxe

void SpbRequestComplete(
  [in] SPBREQUEST Request,
  [in] NTSTATUS   CompletionStatus
);

Paramètres

[in] Request

Un handle SPBREQUEST à la demande d’E/S à terminer. 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.

[in] CompletionStatus

Valeur NTSTATUS qui représente la status d’achèvement de la demande. Les valeurs status valides incluent, sans s’y limiter, les éléments suivants :

STATUS_SUCCESS

La demande d’E/S s’est terminée avec succès.

STATUS_CANCELLED

La demande d’E/S est annulée.

STATUS_UNSUCCESSFUL

Le pilote a rencontré une erreur lors du traitement de la demande d’E/S.

Valeur de retour

None

Remarques

Votre pilote de contrôleur appelle cette méthode pour effectuer une demande d’E/S qu’il a reçue précédemment lors de l’un des rappels suivants :

EvtSpbControllerIoOther EvtSpbControllerIoRead EvtSpbControllerIoSequence EvtSpbControllerIoWriteAppelez SpbRequestComplete au lieu de la méthode WdfRequestComplete pour terminer les demandes d’E/S reçues par les fonctions de rappel de la liste précédente.

Un bogue case activée se produit si l’appelant fournit un handle SPBREQUEST non valide.

Un appel à SpbRequestComplete représente l’étape finale du traitement d’une demande d’E/S. Lorsque cette méthode retourne, la valeur de handle request n’est plus valide.

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