Função StorPortGetPfns (storport.h)
Um miniporto pode chamar o StorPortGetPfns para recuperar os números de quadro de página (Pfns) para a memória descrita pelo MDL especificado (lista de descritores de memória) associado a um SRB.
Sintaxe
ULONG StorPortGetPfns(
[in] PVOID HwDeviceExtension,
[in] PSCSI_REQUEST_BLOCK Srb,
[in] PVOID Mdl,
[out] PVOID *Pfns,
[out] ULONG *PfnCount,
[out] ULONG *StartingOffset
);
Parâmetros
[in] HwDeviceExtension
Um ponteiro para a extensão do dispositivo de hardware. Essa é uma área de armazenamento por HBA que o driver de porta aloca e inicializa em nome do driver de miniporto.
Os drivers de miniporto geralmente armazenam informações específicas do HBA nessa extensão, como o estado do HBA e os intervalos de acesso mapeados para o HBA. Essa área está disponível para o driver de miniporto no DeviceExtension->HwDeviceExtension membro do objeto do dispositivo para o HBA imediatamente após o driver de miniporto chamar StorPortInitialize. O driver de porta libera essa memória quando remove o dispositivo.
[in] Srb
Um ponteiro para o SRB (bloco de solicitação SCSI) de origem. A partir do Windows 8, o parâmetro Srb pode apontar para SCSI_REQUEST_BLOCK ou STORAGE_REQUEST_BLOCK.
[in] Mdl
Um ponteiro para o MDL para o qual os Pfns são solicitados. Somente MDLs obtidos usando StorPortGetOriginalMdl ou StorPortGetDataInBufferMdl são compatíveis.
[out] Pfns
Ponteiro para uma matriz de Pfns associada ao MDL. Os chamadores não devem modificar, atualizar ou liberar a lista.
[out] PfnCount
O número de Pfns na matriz que Pfns aponta.
[out] StartingOffset
Especifica o deslocamento de bytes na página inicial do buffer descrito pelo MDL fornecido.
Valor de retorno
StorPortGetPfns retorna um dos seguintes códigos de status:
| Código de retorno | Descrição |
|---|---|
| STOR_STATUS_NOT_IMPLEMENTED | Essa função não é implementada no sistema operacional ativo. |
| STOR_STATUS_SUCCESS | A função foi concluída com êxito. |
| STOR_STATUS_INVALID_PARAMETER | Um ponteiro para um dos parâmetros é NULL. |
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino |
Universal |
| cabeçalho | storport.h |