PSCSIWMI_QUERY_REGINFO fonction de rappel (scsiwmi.h)

Article
02/07/2025

Une routine de du pilote miniport HwScsiWmiQueryReginfo est appelée pour obtenir des informations sur les données et les blocs d’événements à inscrire pour le compte du pilote miniport par le pilote de port SCSI. Cette routine est requise.

Remarque Le pilote de port SCSI et les modèles de pilotes miniport SCSI peuvent être modifiés ou indisponibles à l’avenir. Au lieu de cela, nous vous recommandons d’utiliser le du pilote Storport et modèles de pilotes Storport miniport.

Syntaxe

PSCSIWMI_QUERY_REGINFO PscsiwmiQueryReginfo;

UCHAR PscsiwmiQueryReginfo(
  [in]  PVOID DeviceContext,
  [in]  PSCSIWMI_REQUEST_CONTEXT RequestContext,
  [out] PWSTR *MofResourceName
)
{...}

Paramètres

[in] DeviceContext

Pointe vers la valeur de contexte définie par le pilote miniport passée à ScsiPortWmiDispatchFunction.

[in] RequestContext

Pointe vers la structure SCSIWMI_REQUEST_CONTEXT que le pilote miniport a passé à ScsiPortWmiDispatchFunction.

[out] MofResourceName

Pointe vers une chaîne Unicode null-terminated qui indique le nom de la ressource MOF attachée au fichier image binaire du pilote miniport. Cette chaîne peut être déclarée comme constante dans le pilote miniport. Si le pilote miniport n’a pas de ressource MOF attachée, il doit définir MofResourceName sur NULL.

Valeur de retour

HwScsiWmiQueryReginfo retourne toujours SRB_STATUS_SUCCESS.

Remarques

Lorsqu’un pilote miniport reçoit un SRB dans lequel le membre function de est défini sur SRB_FUNCTION_WMI, il appelle ScsiPortWmiDispatchFunction avec un pointeur vers une structure de SCSI_WMILIB_CONTEXT initialisée et MinorFunction défini sur Srb->WmiSubFunction. Si minorFunction indique une demande d’informations d’inscription, le pilote de port SCSI appelle la routine HwScsiWmiQueryReginfo du pilote miniport.

Le pilote miniport fournit des informations d’inscription nouvelles ou mises à jour sur des blocs individuels, ou indique des blocs à supprimer, dans la structure SCSI_WMILIB_CONTEXT qu’il passe à ScsiPortWmiDispatchFunction. Le pilote miniport HwScsiWmiQueryReginfo routine fournit un pointeur vers son nom de ressource MOF.

Le pilote miniport ne doit pas pendre ou bloquer la SRB. Le pilote miniport ne doit pas appeler ScsiPortWmiPostProcess ou ScsiPortNotification à partir de sa routine HwScsiWmiQueryReginfo.

Exigences

Exigence	Valeur
plateforme cible	Bureau
d’en-tête	scsiwmi.h (include Scsiwmi.h)

Voir aussi

SCSIWMI_REQUEST_CONTEXT

SCSI_WMILIB_CONTEXT

ScsiPortWmiDispatchFunction

Partager via