estrutura SDBUS_INTERFACE_STANDARD (ntddsd.h)

Artigo
08/07/2023

A estrutura SDBUS_INTERFACE_STANDARD contém ponteiros para as rotinas de método de um SD (Secure Digital) cartão interface de barramento.

Sintaxe

typedef struct _SDBUS_INTERFACE_STANDARD {
  USHORT                              Size;
  USHORT                              Version;
  PVOID                               Context;
  PINTERFACE_REFERENCE                InterfaceReference;
  PINTERFACE_DEREFERENCE              InterfaceDereference;
  PSDBUS_INITIALIZE_INTERFACE_ROUTINE InitializeInterface;
  PSDBUS_ACKNOWLEDGE_INT_ROUTINE      AcknowledgeInterrupt;
} SDBUS_INTERFACE_STANDARD, *PSDBUS_INTERFACE_STANDARD;

Membros

Size

Indica o tamanho, em bytes, dessa estrutura. O chamador de SdBusOpenInterface deve definir esse membro como sizeof(SDBUS_INTERFACE_STANDARD).

Version

Indica o número de versão da interface. O chamador de SdBusOpenInterface deve definir esse membro como SDBUS_INTERFACE_VERSION.

Context

Ponteiro para informações de contexto que o driver de barramento fornece sempre que um driver de dispositivo abre uma interface com SdBusOpenInterface. Essas informações estão disponíveis para o chamador na saída após a chamada para SdBusOpenInterface. O chamador deve passar essas informações como um parâmetro para outras rotinas de interface.

InterfaceReference

Ponteiro para uma rotina fornecida pelo driver de barramento do tipo PINTERFACE_REFERENCE que incrementa a contagem de referência da interface que está disponível para o chamador da rotina SdBusOpenInterface quando essa rotina retorna. SdBusOpenInterface incrementa automaticamente a contagem de interfaces para uma, portanto, na maioria dos casos, é necessário que o chamador use essa rotina.

Essa rotina segue o formato padrão das rotinas de referência da interface de barramento. Para obter uma descrição do caso geral, consulte INTERFACE.

InterfaceDereference

Ponteiro para uma rotina fornecida pelo driver de barramento do tipo PINTERFACE_DEREFERENCE que diminui a contagem de referência de interface. Se o chamador diminuir a contagem de referência para zero, o driver de barramento fechará a interface.

Essa rotina segue o formato padrão das rotinas de desreferência da interface de barramento. Para obter uma descrição do caso geral, consulte INTERFACE.

Os drivers de dispositivo devem usar essa rotina para desreferenciar a interface nas seguintes condições:

O driver do dispositivo recebe um IRP de remoção de consulta.
O driver do dispositivo recebe um IRP de remoção surpresa.
O driver do dispositivo recebe um IRP de remoção, sem primeiro receber uma remoção de consulta ou um IRP de remoção surpresa.

Em todos esses casos, o driver do dispositivo deve desreferenciar a interface antes de passar o IRP para o motorista do ônibus.

InitializeInterface

Ponteiro para uma rotina fornecida pelo driver de barramento do tipo PSDBUS_INITIALIZE_INTERFACE_ROUTINE que define parâmetros de inicialização na interface.

AcknowledgeInterrupt

Ponteiro para uma rotina fornecida pelo motorista de ônibus do tipo PSDBUS_ACKNOWLEDGE_INT_ROUTINE que o motorista do dispositivo SD usa para notificar o motorista do ônibus de que terminou de processar uma interrupção.

Comentários

Os drivers de dispositivo SD devem obter esse conjunto de rotinas de método para se comunicar com o driver de barramento SD. Os drivers chamam a rotina da biblioteca SdBusOpenInterface para abrir uma interface.