PSCSIWMI_QUERY_REGINFO funzione di callback (scsiwmi.h)

Viene chiamata la routine HwScsiWmiQueryReginfo di un driver miniport per ottenere informazioni sui dati e sui blocchi eventi da registrare per conto del driver miniport dal driver di porta SCSI. Questa routine è obbligatoria.

Nota I modelli di driver porta SCSI e miniport SCSI potrebbero essere modificati o non disponibili in futuro. È invece consigliabile usare driver Storport e modelli di driver miniport Storport.

 

Sintassi

PSCSIWMI_QUERY_REGINFO PscsiwmiQueryReginfo;

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

Parametri

[in] DeviceContext

Punta al valore del contesto definito dal driver miniport passato a ScsiPortWmiDispatchFunction.

[in] RequestContext

Punta alla struttura SCSIWMI_REQUEST_CONTEXT passata dal driver miniport a ScsiPortWmiDispatchFunction.

[out] MofResourceName

Punta a un nullstringa Unicode con terminazione che indica il nome della risorsa MOF collegata al file di immagine binario del driver miniport. Questa stringa può essere dichiarata come costante nel driver miniport. Se il driver miniport non dispone di una risorsa MOF collegata, deve impostare MofResourceName su NULL.

Valore restituito

HwScsiWmiQueryReginfo restituisce sempre SRB_STATUS_SUCCESS.

Osservazioni

Quando un driver miniport riceve un SRB in cui il membro funzione è impostato su SRB_FUNCTION_WMI, chiama ScsiPortWmiDispatchFunction con un puntatore a una struttura SCSI_WMILIB_CONTEXT inizializzata e MinorFunction impostato su Srb->WmiSubFunction. Se MinorFunction indica una richiesta di informazioni di registrazione, il driver della porta SCSI chiama la routine del driver miniport HwScsiWmiQueryReginfo.

Il driver miniport fornisce informazioni di registrazione nuove o aggiornate sui singoli blocchi o indica i blocchi da rimuovere, nella struttura SCSI_WMILIB_CONTEXT passa a ScsiPortWmiDispatchFunction. Il driver miniport HwScsiWmiQueryReginfo routine fornisce un puntatore al nome della risorsa MOF.

Il driver miniport non deve eseguire la penna o bloccare SRB. Il driver miniport non deve chiamare ScsiPortWmiPostProcess o ScsiPortNotification dalla routine HwScsiWmiQueryReginfo.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Desktop
intestazione	scsiwmi.h (include Scsiwmi.h)

Vedere anche

SCSIWMI_REQUEST_CONTEXT

SCSI_WMILIB_CONTEXT

ScsiPortWmiDispatchFunction