Freigeben über


ScsiPortWmiGetInstanceName-Funktion (scsiwmi.h)

Die ScsiPortWmiGetInstanceName Routine gibt einen Zeiger auf den Instanznamen zurück, der dem angegebenen Windows Management Instrumentation (WMI) SCSI-Anforderungsblock (SRB) zugeordnet ist.

Hinweis Der SCSI-Porttreiber und die SCSI-Miniporttreibermodelle können in Zukunft geändert oder nicht mehr verfügbar sein. Stattdessen empfehlen wir die Verwendung des Storport-Treibers und Storport Miniport Treibermodelle.
 

Syntax

PWCHAR ScsiPortWmiGetInstanceName(
  [in] PSCSIWMI_REQUEST_CONTEXT RequestContext
);

Parameter

[in] RequestContext

Zeiger auf eine Struktur vom Typ SCSIWMI_REQUEST_CONTEXT, die den Anforderungskontext für einen WMI-SRB enthält.

Rückgabewert

Zeigen Sie auf eine gezählte Zeichenfolge, die den Instanznamen enthält, der dem angegebenen SRB zugeordnet ist. Wenn der SRB-Typ einer ist, der keinen Instanznamen verwendet, gibt ScsiPortWmiGetInstanceNameNULL-zurück.

Bemerkungen

Der Parameter RequestContext verweist auf eine Anforderungskontextstruktur, SCSIWMI_REQUEST_CONTEXT, die Informationen enthält, die einem Windows Management Instrumentation (WMI) SCSI-Anforderungsblock (WMI) zugeordnet sind. Die Anforderungskontextstruktur enthält wiederum eine der WMI-WNODE_XXX Structures, die vom WMI-System verwendet wird, um Daten zwischen Consumern im Benutzermodus und Kernelmodusdatenanbietern wie Treibern zu übergeben.

Die im Anforderungskontext enthaltene WNODE_XXX Struktur enthält einen Instanznamen, der dem WMI-SRB zugeordnet ist. Der Miniporttreiber ruft ScsiPortWmiGetInstanceName- auf, um diesen Instanznamen aus dem Anforderungskontext zu extrahieren.

Der für den Anforderungskontext zugewiesene Speicher muss gültig bleiben, bis der Miniporttreiber ScsiPortWmiPostProcess-aufruft und ScsiPortWmiPostProcess die endgültige SRB-Status- und Puffergröße zurückgibt. Wenn der SRB pendieren kann, sollte der Speicher für den Anforderungskontext von der SRB-Erweiterung zugewiesen werden. Wenn der SRB nicht pendiert werden kann, kann der Speicher aus einem Stapelframe zugewiesen werden, der nicht außerhalb des Gültigkeitsbereichs liegt.

Anforderungen

Anforderung Wert
Zielplattform- Desktop
Header- scsiwmi.h (include Miniport.h, Scsi.h)

Siehe auch

SCSIWMI_REQUEST_CONTEXT

WNODE_ALL_DATA

WNODE_SINGLE_INSTANCE