SpbRequestGetParameters-Funktion (spbcx.h)

Artikel
08/07/2023

Die SpbRequestGetParameters-Methode ruft einen Satz SPB-spezifischer Parameterwerte aus einer E/A-Anforderung ab.

Syntax

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

Parameter

[in] SpbRequest

Ein SPBREQUEST-Handle für die E/A-Anforderung. Der SPB-Controllertreiber hat dieses Handle zuvor über eine seiner registrierten Ereignisrückruffunktionen empfangen.

[out] Parameters

Ein Zeiger auf eine vom Aufrufer zugeordnete SPB_REQUEST_PARAMETERS Struktur, in die die Methode die SPB-spezifischen Parameterwerte aus der E/A-Anforderung schreibt. Der Aufrufer muss diese Struktur zuvor initialisiert haben, indem er die funktion SPB_REQUEST_PARAMETERS_INIT aufruft.

Rückgabewert

Keine

Bemerkungen

SpbRequestGetParameters ähnelt der WdfRequestGetParameters-Methode , ruft jedoch nur SPB-spezifische Informationen ab. Ihr SPB-Controllertreiber kann SpbRequestGetParameters aufrufen, um SPB-spezifische Informationen aus E/A-Anforderungen abzurufen, die er von der SPB-Frameworkerweiterung (SpbCx) empfängt. Der SPB-Controllertreiber kann WdfRequestGetParameters aufrufen, um die generischen Anforderungsparameter aus empfangenen E/A-Anforderungen abzurufen.

Beispiele

Das folgende Codebeispiel zeigt, wie SpbRequestGetParameters verwendet wird, um die SPB-spezifischen Parameter aus einer E/A-Anforderung abzurufen. Die SpbRequest-Variable enthält ein SPBREQUEST-Handle für die E/A-Anforderung.

SPB_REQUEST_PARAMETERS parameters;

SPB_REQUEST_PARAMETERS_INIT(&parameters);

SpbRequestGetParameters(spbRequest, &parameters);

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar ab Windows 8.
Zielplattform	Universell
Header	spbcx.h
Bibliothek	Spbcxstubs.lib
IRQL	<= DISPATCH_LEVEL