Rotinas de suporte ao driver do Storport

Esta página categoriza algumas das rotinas de suporte fornecidas aos miniportos pelo driver Storport fornecido pelo sistema. Consulte storport.h para obter uma lista completa.

Para obter uma lista de rotinas de miniporto de driver do Storport, consulte Rotinas de driver do Storport Miniport.

Rotinas de suporte de acesso direto à memória

O driver storport fornece as seguintes rotinas de suporte de DMA (acesso direto à memória).

Rotina	Descrição
StorPortBuildScatterGatherList	Cria uma lista de dispersão/coleta para o buffer de dados especificado.
StorPortGetScatterGatherList	Recupera a lista de dispersão/coleta associada para o SRB (bloco de solicitação SCSI) especificado.
StorPortPutScatterGatherList	Libera todos os recursos associados a uma lista de dispersão/coleta que foi criada anteriormente por uma chamada para a rotina StorPortBuildScatterGatherList .

Rotinas gerais de suporte

O Storport fornece as seguintes rotinas gerais de suporte.

Rotina	Descrição
StorPortDebugPrint	Imprime uma cadeia de caracteres de depuração no depurador de kernel, se o depurador estiver anexado.
StorPortEtwEvent2	Publica um evento ETW (Rastreamento de Eventos para Windows) em um canal de rastreamento de armazenamento. O miniporto pode registrar dois parâmetros ETW de uso geral. Os parâmetros ETW são expressos como dois pares nome-valor.
StorPortEtwEvent4	Publica um evento ETW em um canal de rastreamento de armazenamento. O miniporto pode registrar quatro parâmetros ETW de uso geral. Os parâmetros ETW são expressos como quatro pares nome-valor.
StorPortEtwEvent8	Publica um evento ETW em um canal de rastreamento de armazenamento. O miniporto pode registrar oito parâmetros ETW de uso geral. Os parâmetros ETW são expressos como oito pares nome-valor.
StorPortGetActivityIdSrb	Recupera a ID da atividade ETW associada a um bloco de solicitação.
StorPortGetDeviceObjects	Retorna os objetos de dispositivo associados à pilha de dispositivos do adaptador. Os objetos de dispositivo que serão retornados são os objetos de dispositivo funcional e físico do adaptador e o objeto de dispositivo ao qual o objeto de dispositivo funcional está anexado.
StorPortGetSystemPortNumber	Recupera o número da porta atribuída pelo sistema para um adaptador de armazenamento.
StorPortInitializeSListHead	Inicializa o cabeçalho de uma lista vinculada por singport gerenciada pelo Storport.
StorPortInterlockedFlushSList	Remove todos os itens de uma lista vinculada exclusivamente gerenciada pelo Storport. O acesso à lista é sincronizado em um sistema multiprocessador
StorPortInterlockedPopEntrySList	Remove um item da frente de uma lista vinculada pelo Storport. O acesso à lista é sincronizado em um sistema multiprocessador.
StorPortInterlockedPushEntrySList	Insere um item na frente de uma lista vinculada pelo Storport. O acesso à lista é sincronizado em um sistema multiprocessador.
StorPortInvokeAcpiMethod	Executa um método ACPI para um dispositivo de armazenamento.
StorPortIsCurrentOsInstallationUpgrade	Verifica se a instalação atual do Windows é uma atualização de uma versão anterior ou não.
StorPortIsDeviceOperationAllowed	Permite que um miniporto determine se as operações para uma determinada classe de gerenciamento de dispositivos são permitidas.
StorPortLogError	Notifica o driver de porta de que ocorreu um erro.
StorPortLogSystemEvent	Fornece aos drivers de miniporta acesso completo aos recursos do recurso de evento kernel do Windows, permitindo que os drivers de miniporte criem entradas de log de eventos que são realmente úteis na solução de problemas de armazenamento. Ele fornece uma alternativa melhor para StorPortLogError.
StorPortQueryDepthSList	Recupera o número de entradas em uma lista vinculada com singly gerenciada pelo Storport.
StorPortQueryPerformanceCounter	Consulta e retorna o valor atual do contador de desempenho do sistema.
StorPortQuerySystemTime	Obtém a hora atual do sistema.
StorPortRegistryRead	Lê os dados do Registro para o dispositivo e o valor indicados.
StorPortRegistryReadAdapterKey	Lê as chaves do adaptador de registro de hardware ou dispositivo localizadas no Registro em HKLM/CurrentControlSet/Enum/<Instance path>/DeviceParameters/....
StorPortRegistryWriteAdapterKey	Grava as chaves do adaptador de registro de hardware ou dispositivo localizadas no Registro em HKLM/CurrentControlSet/Enum/<Instance path>/DeviceParameters/....
StorPortRegistryWrite	Converte os dados do Registro contidos em um buffer especificado de ASCII em Unicode e grava os dados na área de armazenamento por HBA do driver de miniport.

Rotinas de suporte ao processamento de solicitações de E/S

O Storport fornece as seguintes rotinas de suporte de processamento de solicitação de E/S.

Rotina	Descrição
StorPortBusy	Notifica o driver de porta de que o adaptador está ocupado no momento, tratando solicitações pendentes.
StorPortCompleteRequest	Conclui todas as solicitações pendentes que definem o valor de status SRB como SrbStatus.
StorPortCompleteServiceIrp	Chamado por um driver de miniporto virtual storport quando ele precisa concluir uma solicitação recebida em sua rotina de retorno de chamada HwStorProcessServiceRequest.
StorPortDeviceBusy	Notifica o driver de porta de que a unidade lógica especificada está ocupada no momento, tratando solicitações pendentes.
StorPortDeviceReady	Notifica o driver de porta de que a unidade lógica indicada está pronta para lidar com novas solicitações.
StorPortFreeWorker	Libera um item de trabalho do Storport alocado anteriormente pela rotina StorPortInitializeWorker .
StorPortGetRequestInfo	Recupera as informações de solicitação de E/S associadas a um SRB (bloco de solicitação SCSI) e as retorna em uma estrutura STOR_REQUEST_INFO.
StorPortInitializeWorker	Cria um novo item de trabalho do Storport que é executado em um thread de trabalho do sistema.
StorPortQueueWorkItem	Agenda um item de trabalho do Storport para ser executado dentro do contexto de um thread de trabalho do sistema.
StorPortPause	Pausa um adaptador para o período de tempo especificado.
StorPortPauseDevice	Pausa um dispositivo de unidade lógica específico para o período de tempo especificado.
StorPortReady	Notifica o driver de porta de que o adaptador não está mais ocupado.
StorPortResume	Retoma um adaptador pausado.
StorPortResumeDevice	Retoma uma unidade lógica pausada anteriormente.

Rotinas de suporte de inicialização

O driver do Storport fornece as seguintes rotinas de suporte de inicialização.

Rotina	Descrição
StorPortEnablePassiveInitialization	Permite que a rotina de retorno de chamada HwStorPassiveInitializeRoutine do miniporte seja executada em PASSIVE_LEVEL durante a inicialização do miniporto.
StorPortGetActiveGroupCount	Retorna o número de grupos de processadores presentes no sistema.
StorPortGetActiveNodeCount	Retorna o número de nós presentes no sistema.
StorPortGetBusData	Recupera as informações de configuração específicas do barramento necessárias para inicializar o HBA.
StorPortGetCurrentProcessorNumber	Recupera o número do processador atual do kernel.
StorPortGetGroupAffinity	Constrói uma máscara dos processadores ativos em um grupo solicitado.
StorPortGetHighestNodeNumber	Retorna o maior número de nó possível no sistema.
StorPortGetLogicalProcessorRelationship	Retorna informações de relação para um ou mais tipos especificados. Esses tipos incluem grupos, pacotes físicos e nós no sistema host. As informações retornadas incluem máscaras de afinidade de processador compostas pelos processadores lógicos no sistema host. Esses processadores lógicos compartilham os tipos de relação especificados.
StorPortGetLogicalUnit	Retorna um ponteiro para a área de armazenamento por unidade lógica do driver de miniport.
StorPortGetNodeAffinity	Constrói uma máscara dos processadores ativos em um nó NUMA (acesso não uniforme à memória) solicitado.
StorPortGetStartIoPerfParams	Places os parâmetros de desempenho para uma determinada solicitação de E/S em uma estrutura STARTIO_PERFORMANCE_PARAMETERS.
StorPortInitialize	Inicializa os parâmetros do driver de porta e os dados de extensão. StorPortInitilize também salva as informações do adaptador fornecidas do driver de miniport.
StorPortInitializePerfOpts	Inicializa as otimizações de desempenho às quais o driver de miniporto e o driver storport dão suporte usando uma estrutura PERF_CONFIGURATION_DATA.
StorPortSetAdapterBusType	Usado para ajustar o BusType do adaptador dependendo de sua configuração atual. Definir o BusType com essa rotina permitirá que você substitua a propriedade global definida no miniport inf sem precisar reinstalar o driver. Isso é útil para cenários como suporte a RAID ou suporte para vários adaptadores com um tipo de barramento diferente.
StorPortSetBusDataByOffset	Grava informações de configuração específicas do barramento.
StorPortSetDeviceQueueDepth	Define a profundidade máxima da fila do dispositivo para o dispositivo indicado.
StorPortSetPowerSettingNotificationGuids	Permite que um miniporto receba notificações de configuração de energia. O miniporto registra uma matriz de GUIDs que identificam as configurações de energia para as quais receber notificações de alteração de energia.
StorPortSetUnitAttributes	Registra os atributos de energia de um dispositivo de unidade de armazenamento com o driver Storport.

Rotinas de suporte de interrupção

O driver do Storport fornece as seguintes rotinas de suporte de interrupção.

Rotina	Descrição
StorPortGetMSIInfo	Recupera as informações de MSI (interrupção sinalizada por mensagem) para a mensagem especificada.
StorPortSynchronizeAccess	Fornece acesso sincronizado à extensão de dispositivo de um driver de miniport.
StorPortInitializeDpc	Inicializa uma DPC (chamada de procedimento adiado) do StorPort
StorPortIssueDpc	Emite um DPC do Storport.
StorPortStallExecution	Para o motorista do miniporta.

Rotinas de suporte de bloqueio

O driver do Storport fornece as seguintes rotinas de suporte de bloqueio.

Rotina	Descrição
StorPortAcquireMSISpinLock	Adquire o bloqueio de rotação msi (interrupção sinalizada por mensagem) associado à mensagem especificada.
StorPortAcquireSpinLock	Adquire o bloqueio de rotação especificado.
StorPortReleaseMSISpinLock	Libera um bloqueio de rotação msi adquirido anteriormente para a mensagem especificada.
StorPortReleaseSpinLock	Libera um spinlock adquirido pelo StorPortAcquireSpinLock.

Rotinas de suporte de gerenciamento de memória

O driver do Storport fornece as seguintes rotinas de suporte de gerenciamento de memória.

Rotina	Descrição
StorPortAllocateContiguousMemorySpecifyCacheNode	Aloca um intervalo de memória não armazenada em cache e nãopagada fisicamente contígua.
StorPortAllocateMdl	Aloca um MDL para descrever a memória de pool não paginada fornecida.
StorPortAllocatePool	Aloca um bloco de memória de pool não contígua e não paginada.
StorPortAllocateRegistryBuffer	Aloca um buffer que pode ser usado por um miniporto para ler e gravar dados do Registro.
StorPortBuildMdlForNonPagedPool	Atualizações o MDL para descrever a memória não paginada associada.
StorPortConvertUlongToPhysicalAddress	Converte um endereço longo sem sinal em um endereço físico.
StorPortConvertPhysicalAddressToULong64	Converte um endereço físico em um valor de ULONG64.
StorPortFreeMdl	Libera uma MDL (lista de descritores de memória) que descreve a memória do pool não paginada.
StorPortFreeContiguousMemorySpecifyCache	Desaloca um intervalo de memória não em cache na parte nãopagada do espaço de endereço do sistema.
StorPortFreePool	Libera um bloco de memória que foi alocado anteriormente por uma chamada para a rotina StorPortAllocatePool .
StorPortFreeRegistryBuffer	Libera o buffer alocado para armazenar dados do Registro.
StorPortGetDataInBufferMdl	Retorna um MDL associado ao buffer de dados de entrada de um SRB (bloco de solicitação SCSI).
StorPortGetDataInBufferScatterGatherList	Retorna a lista de coleta de dispersão associada ao buffer de dados de entrada de um SRB (bloco de solicitação SCSI).
StorPortGetDataInBufferSystemAddress	Retorna o endereço do sistema para o buffer de dados de entrada de um SRB (bloco de solicitação SCSI).
StorPortGetOriginalMdl	Retorna o MDL associado ao SRB fornecido.
StorPortGetVirtualAddress	Obtém um endereço virtual que é mapeado para o endereço físico indicado.
StorPortGetPhysicalAddress	Converte um determinado intervalo de endereços virtuais em um intervalo de endereços físicos para uma operação de DMA.
StorPortGetSystemAddress	Retorna um endereço virtual no espaço do sistema para o buffer de dados do SRB (bloco de solicitação SCSI) especificado.
StorPortGetUncachedExtension	Aloca um buffer comum não armazenado em cache a ser compartilhado pela CPU e pelo dispositivo.
StorPortMarkDumpMemory	Um miniporto deve marcar a memória usada para o arquivo de despejo ou o arquivo de hibernação. A memória marcada é retida e permanece válida após um currículo da operação de hibernação. A memória a ser marcada é especificada por um endereço e comprimento de intervalo em uma chamada para StorPortMarkDumpMemory.
StorPortMoveMemory	Copia a memória de um buffer para outro.

Rotinas de suporte de notificação

O driver storport fornece as seguintes rotinas de suporte de notificação.

Rotina	Descrição
StorPortAsyncNotificationDetected	Notifica o driver storport de um dispositivo de armazenamento status evento de alteração.
StorPortNotification	Notifica o driver storport de determinados eventos e condições.
StorPortStateChangeDetected	Notifica o driver de porta storport de uma alteração de estado para um LUN (número de unidade lógica), porta HBA (adaptador de barramento de host) ou dispositivo de destino.

Portar e registrar rotinas de suporte de E/S

O driver storport fornece a porta a seguir e registra rotinas de suporte de E/S.

Rotina	Descrição
StorPortGetDeviceBase	Mapeia um endereço de E/S para o espaço de endereço do sistema.
StorPortFreeDeviceBase	Libera um intervalo de memória de E/S do dispositivo que foi mapeado por StorPortGetDeviceBase.
StorPortReadPortBufferUchar	Lê um valor de um endereço de porta especificado
StorPortReadPortBufferUlong	Lê um valor de um endereço de porta especificado.
StorPortReadPortBufferUshort	Lê um valor de um endereço de porta especificado.
StorPortReadPortUchar	Lê um valor de um endereço de porta especificado
StorPortReadPortUlong	Lê um valor de um endereço de porta especificado.
StorPortReadPortUshort	Lê um valor de um endereço de porta especificado.
StorPortReadRegisterBufferUchar	Lê um valor de um endereço de registro especificado.
StorPortReadRegisterBufferUlong	Lê um valor de um endereço de registro especificado.
StorPortReadRegisterBufferUlong64	Lê vários valores de ULONG64 do endereço de registro de 64 bits especificado em um buffer.
StorPortReadRegisterBufferUshort	Lê um valor de um endereço de registro especificado.
StorPortReadRegisterUchar	Lê um valor de um endereço de registro especificado.
StorPortReadRegisterUlong	Lê um valor de um endereço de registro especificado.
StorPortReadRegisterUlong64	Lê um valor de 64 bits de um endereço de registro de 64 bits especificado.
StorPortReadRegisterUshort	Lê um valor de um endereço de registro especificado.
StorPortValidateRange	Determina se um intervalo especificado de endereços de E/S está em uso por outro adaptador. Essa rotina é obsoleta em sistemas operacionais Windows NT 4.0 e posteriores.
StorPortWritePortBufferUchar	Grava um valor em um endereço de registro especificado.
StorPortWritePortBufferUlong	Grava um valor em um endereço de registro especificado.
StorPortWritePortBufferUshort	Grava um valor em um endereço de registro especificado.
StorPortWritePortUchar	Grava um valor em um endereço de registro especificado.
StorPortWritePortUlong	Grava um valor em um endereço de registro especificado.
StorPortWritePortUshort	Grava um valor em um endereço de registro especificado.
StorPortWriteRegisterBufferUchar	Transfere um determinado número de bytes não assinados de um buffer para o HBA.
StorPortWriteRegisterBufferUlong	Transfere um determinado número de valores ULONG de um buffer para o HBA.
StorPortWriteRegisterBufferUlong64	Grava vários valores de ULONG64 de um endereço de registro de 64 bits especificado.
StorPortWriteRegisterBufferUshort	Transfere um determinado número de valores USHORT de um buffer para o HBA.
StorPortWriteRegisterUchar	Transfere um determinado número de valores de caractere de um buffer para o endereço de registro HBA indicado.
StorPortWriteRegisterUlong	Transfere um valor ULONG para o endereço de registro HBA indicado.
StorPortWriteRegisterUlong64	Grava um valor de ULONG64 no endereço de registro especificado.
StorPortWriteRegisterUshort	Transfere um valor ULONG para o endereço de registro HBA indicado.

Rotinas de suporte do Gerenciamento de Energia de Runtime

O driver do Storport fornece as seguintes rotinas de suporte de gerenciamento de energia de runtime.

Rotina	Descrição
StorPortInitializePoFxPower	Registra um dispositivo de armazenamento com a PoFx (estrutura de gerenciamento de energia).
StorPortPoFxActivateComponent	Incrementa a contagem de referência de ativação no componente especificado de um dispositivo de armazenamento.
StorPortPoFxIdleComponent	Diminui a contagem de referência de ativação de um componente especificado de um dispositivo de armazenamento.
StorPortPoFxPowerControl	Envia uma solicitação de controle de energia para a PoFx (estrutura de gerenciamento de energia) para encaminhar para o PEP (plug-in do power engine).
StorPortPoFxSetComponentLatency	Especifica a latência máxima que pode ser tolerada na transição da condição ociosa para a condição ativa no componente de dispositivo de armazenamento especificado.
StorPortPoFxSetComponentResidency	Define o tempo estimado para quanto tempo um componente de dispositivo de armazenamento provavelmente permanecerá ocioso depois que o componente entrar na condição ociosa.

Rotinas de suporte do temporizador

O driver do Storport fornece as seguintes rotinas de suporte ao temporizador.

Rotina	Descrição
StorPortFreeTimer	Libera um objeto de contexto de temporizador storport criado anteriormente pela rotina StorPortInitializeTimer .
StorPortInitializeTimer	Cria um objeto de contexto de temporizador do Storport.
StorPortRequestTimer	Agenda um evento de retorno de chamada para um objeto de contexto de temporizador do Storport.