Compartilhar via


HW_STATE_CHANGE função de retorno de chamada (storport.h)

Um retorno de chamada fornecido pelo miniport que é chamado após uma notificação de StorPortStateChangeDetected é processado.

Sintaxe

HW_STATE_CHANGE HwStateChange;

void HwStateChange(
                 PVOID HwDeviceExtension,
  [in, optional] PVOID Context,
  [in]           SHORT AddressType,
  [in]           PVOID Address,
  [in]           ULONG Status
)
{...}

Parâmetros

HwDeviceExtension

[in] Um ponteiro para a área de armazenamento por HBA do driver de miniporto.

[in, optional] Context

O contexto fornecido como HwStateChangeContext pelo miniporto na chamada para StorPortStateChangeDetected.

[in] AddressType

O tipo do endereço no endereço .

[in] Address

Um ponteiro para uma estrutura STOR_ADDRESS para a entidade cuja alteração de estado foi processada.

[in] Status

O status de processamento da notificação de alteração de estado.

Valor de retorno

Nenhum

Observações

O HwStorStateChange é chamado com o bloqueio StartIo adquirido pelo Storport.

Esse retorno de chamada permite que os miniportos façam qualquer processamento adicional necessário após a adição ou remoção de hardware. Se ocorrer uma alteração de hardware na porta ou barramento do HBA, o miniporto poderá chamar StorPortStateChangeDetected para alertar o sistema do evento.

Se o valor de Status for < 0x80000000, o processamento da notificação foi bem-sucedido. Caso contrário, o processo de notificação falhou.

O nome HwStorStateChange é apenas um espaço reservado para a função de miniporto que é apontada pelo parâmetro HwStateChange de StorPortStateChangeDetected. O protótipo real dessa rotina é definido em storport.h da seguinte maneira:

typedef
VOID
HW_STATE_CHANGE (
    _In_ PVOID HwDeviceExtension,
    _In_opt_ PVOID Context,
    _In_ SHORT AddressType,
    _In_ PVOID Address,
    _In_ ULONG Status
    );

Requisitos

Requisito Valor
de cliente com suporte mínimo Disponível no Windows 8 e versões posteriores do Windows.
da Plataforma de Destino Universal
cabeçalho storport.h (inclua Storport.h)
IRQL DESPACHAR

Consulte também

STOR_ADDRESS

StorPortStateChangeDetected