PSCSIWMI_QUERY_REGINFO fonction de rappel (scsiwmi.h)

Article
02/26/2024

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.

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

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 .