PSCSIWMI_QUERY_REGINFO funzione di callback (SCSIwmi.h)

Articolo
08/07/2023

La routine HwSCSIWmiQueryReginfo di un driver miniport viene chiamata per ottenere informazioni sui dati e sui blocchi eventi da registrare per conto del driver miniport dal driver della porta SCSI. Questa routine è necessaria.

Nota I modelli di driver di porta SCSI e miniport SCSI possono essere modificati o non disponibili in futuro. È invece consigliabile usare i modelli di driver Storport e 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 di contesto definito dal driver miniport passato a SCSIPortWmiDispatchFunction.

[in] RequestContext

Punta alla struttura SCSIWMI_REQUEST_CONTEXT che il driver miniport passato a SCSIPortWmiDispatchFunction.

[out] MofResourceName

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

Valore restituito

HwScsiWmiQueryReginfo restituisce sempre SRB_STATUS_SUCCESS.

Commenti

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

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

Il driver miniport non deve pennare o bloccare la SRB. Il driver miniport non deve chiamare SCSIPortWmiPostProcess o SCSIPortNotification dalla routine HwScsiWmiQueryReginfo .

Requisiti

Requisito	Valore
Piattaforma di destinazione	Desktop
Intestazione	SCSIwmi.h (include SCSIwmi.h)

Vedi anche

SCSIWMI_REQUEST_CONTEXT

SCSI_WMILIB_CONTEXT

SCSIPortWmiDispatchFunction

Condividi tramite