ScsiPortWmiGetInstanceName-Funktion (scsiwmi.h)
Die ScsiPortWmiGetInstanceName-Routine gibt einen Zeiger auf den instance Namen zurück, der dem angegebenen SCSI-Anforderungsblock (Windows Management Instrumentation, WMI) 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
Zeiger auf eine gezählte Zeichenfolge, die den instance Namen enthält, der dem angegebenen SRB zugeordnet ist. Wenn der SRB-Typ keinen instance Namen verwendet, gibt ScsiPortWmiGetInstanceNameNULL zurück.
Hinweise
Der Parameter RequestContext verweist auf eine Anforderungskontextstruktur SCSIWMI_REQUEST_CONTEXT, die Informationen enthält, die einem SCSI-Anforderungsblock ( Windows Management Instrumentation , WMI) zugeordnet sind. Die Anforderungskontextstruktur enthält wiederum eine der WMI-WNODE_XXX-Strukturen , die vom WMI-System verwendet wird, um Daten zwischen Benutzermodusdatenverbrauchern und Kernelmodusdatenanbietern wie Treibern zu übergeben.
Die im Anforderungskontext enthaltene WNODE_XXX-Struktur enthält einen instance Namen, der dem WMI-SRB zugeordnet ist. Der Miniporttreiber ruft ScsiPortWmiGetInstanceName auf, um diesen instance Namen aus dem Anforderungskontext zu extrahieren.
Der für den Anforderungskontext zugewiesene Arbeitsspeicher muss gültig bleiben, bis der Miniporttreiber ScsiPortWmiPostProcess aufgerufen hat, und ScsiPortWmiPostProcess gibt die endgültige SRB-status- und Puffergröße zurück. Wenn der SRB einen Stift verwenden kann, sollte der Arbeitsspeicher für den Anforderungskontext aus der SRB-Erweiterung zugewiesen werden. Wenn der SRB keinen Stift erstellen kann, kann der Arbeitsspeicher aus einem Stapelrahmen zugewiesen werden, der nicht aus dem Bereich herausgeht.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | scsiwmi.h (einschließlich Miniport.h, Scsi.h) |