Función ScsiPortWmiGetInstanceName (scsiwmi.h)
La rutina ScsiPortWmiGetInstanceName devuelve un puntero al nombre de instancia asociado al indicado bloque de solicitud SCSI (SRB) del Instrumental de administración de Windows (WMI).
Sintaxis
PWCHAR ScsiPortWmiGetInstanceName(
[in] PSCSIWMI_REQUEST_CONTEXT RequestContext
);
Parámetros
[in] RequestContext
Puntero a una estructura de tipo SCSIWMI_REQUEST_CONTEXT que contiene el contexto de solicitud de un SRB de WMI.
Valor devuelto
Puntero a una cadena contada que contiene el nombre de instancia asociado a la SRB indicada. Si el tipo SRB es aquel que no usa un nombre de instancia, ScsiPortWmiGetInstanceName devuelve NULL.
Comentarios
El parámetro RequestContext apunta a una estructura de contexto de solicitud, SCSIWMI_REQUEST_CONTEXT, que contiene información asociada a un bloque de solicitud SCSI (SRB) de Instrumental de administración de Windows (WMI). La estructura de contexto de solicitud, a su vez, contiene una de las estructuras de WMI WNODE_XXX que usa el sistema WMI para pasar datos entre consumidores de datos en modo de usuario y proveedores de datos en modo kernel, como controladores.
La estructura de WNODE_XXX contenida en el contexto de solicitud contiene un nombre de instancia asociado a la SRB de WMI. El controlador de minipuerto llama a ScsiPortWmiGetInstanceName para extraer este nombre de instancia del contexto de la solicitud.
La memoria asignada para el contexto de solicitud debe permanecer válida hasta que el controlador de miniporte llame a ScsiPortWmiPostProcess y ScsiPortWmiPostProcess devuelva el estado final de SRB y el tamaño del búfer. Si la SRB puede estar en lápiz, se debe asignar la memoria del contexto de solicitud desde la extensión SRB. Si la SRB no se puede lápiz, la memoria se puede asignar desde un marco de pila que no sale del ámbito.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Escritorio |
| Encabezado | scsiwmi.h (incluye Miniport.h, Scsi.h) |