Funzione StorPortGetPfns (storport.h)

Articolo
11/08/2024

Un miniport può chiamare il StorPortGetPfns per recuperare i numeri di fotogrammi di pagina (Pfns) per la memoria descritta dall'elenco MDL (descrittore di memoria) specificato associato a un SRB.

Sintassi

ULONG StorPortGetPfns(
  [in]  PVOID               HwDeviceExtension,
  [in]  PSCSI_REQUEST_BLOCK Srb,
  [in]  PVOID               Mdl,
  [out] PVOID               *Pfns,
  [out] ULONG               *PfnCount,
  [out] ULONG               *StartingOffset
);

Parametri

[in] HwDeviceExtension

Puntatore all'estensione del dispositivo hardware. Si tratta di un'area di archiviazione per hba che il driver di porta alloca e inizializza per conto del driver miniport.

I driver Miniport archivia in genere informazioni specifiche di HBA in questa estensione, ad esempio lo stato dell'HBA e gli intervalli di accesso mappati per l'HBA. Questa area è disponibile per il driver miniport nel DeviceExtension->HwDeviceExtension membro dell'oggetto dispositivo per l'HBA immediatamente dopo che il driver miniport chiama StorPortInitialize. Il driver della porta libera questa memoria quando rimuove il dispositivo.

[in] Srb

Puntatore al blocco di richieste SCSI di origine (SRB). A partire da Windows 8, il parametro Srb può puntare a SCSI_REQUEST_BLOCK o STORAGE_REQUEST_BLOCK.

[in] Mdl

Puntatore al file MDL per il quale vengono richiesti i pfns. Sono supportati solo gli MDL ottenuti con StorPortGetOriginalMdl o StorPortGetDataInBufferM dl.

[out] Pfns

Puntatore a una matrice di pfns associati al file MDL. I chiamanti non devono modificare, aggiornare o liberare l'elenco.

[out] PfnCount

Numero di pfns nella matrice a cui pfns punta.

[out] StartingOffset

Specifica l'offset di byte all'interno della pagina iniziale del buffer descritto dal codice MDL specificato.

Valore restituito

StorPortGetPfns restituisce uno dei codici di stato seguenti:

Codice restituito	Descrizione
STOR_STATUS_NOT_IMPLEMENTED	Questa funzione non viene implementata nel sistema operativo attivo.
STOR_STATUS_SUCCESS	La funzione è stata completata correttamente.
STOR_STATUS_INVALID_PARAMETER	Un puntatore a uno dei parametri è NULL.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Universale
intestazione	storport.h

Vedere anche

StorPortGetDataInBufferMdl

StorPortGetOriginalMdl

StorPortInitialize

Condividi tramite