PSCSIWMI_QUERY_REGINFO fonction de rappel (scsiwmi.h)
La routine HwScsiWmiQueryReginfo d’un pilote miniport est appelée pour obtenir des informations sur les blocs de données et d’événements à inscrire au nom du pilote miniport par le pilote de port SCSI. Cette routine est obligatoire.
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 transmise à ScsiPortWmiDispatchFunction.
[out] MofResourceName
Pointe vers une chaîne Unicode terminée par null 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 en tant que 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 retournée
HwScsiWmiQueryReginfo retourne toujours SRB_STATUS_SUCCESS.
Remarques
Lorsqu’un pilote miniport reçoit un SRB dans lequel le membre function est défini sur SRB_FUNCTION_WMI, il appelle ScsiPortWmiDispatchFunction avec un pointeur vers une structure 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 les blocs individuels, ou indique les blocs à supprimer, dans la structure SCSI_WMILIB_CONTEXT qu’il transmet à ScsiPortWmiDispatchFunction. La routine HwScsiWmiQueryReginfo du pilote miniport fournit un pointeur vers son nom de ressource MOF.
Le pilote miniport ne doit pas bloquer ou bloquer le SRB. Le pilote miniport ne doit pas appeler ScsiPortWmiPostProcess ou ScsiPortNotification à partir de sa routine HwScsiWmiQueryReginfo .
Configuration requise
Condition requise | Valeur |
---|---|
Plateforme cible | Desktop (Expérience utilisateur) |
En-tête | scsiwmi.h (inclure Scsiwmi.h) |