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.
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) |