SDBUS_INTERFACE_STANDARD estrutura (ntddsd.h)
A estrutura de SDBUS_INTERFACE_STANDARD contém ponteiros para as rotinas de método de uma interface de barramento de cartão SD (Secure Digital).
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 tamanhos de(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 ônibus 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 motorista de ônibus do tipo PINTERFACE_REFERENCE que incrementa a contagem de referência da interface que está disponível para o chamador do rotina de SdBusOpenInterface quando essa rotina retorna. SdBusOpenInterface incrementa automaticamente a contagem de interface para um, 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 do barramento. Para obter uma descrição do caso geral, consulte INTERFACE.
InterfaceDereference
Ponteiro para uma rotina fornecida pelo motorista de ônibus do tipo PINTERFACE_DEREFERENCE que diminui a contagem de referência da interface. Se o chamador diminuir a contagem de referência como zero, o motorista do ônibus fechará a interface.
Essa rotina segue o formato padrão das rotinas de desreferência da interface do 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 uma consulta para remover IRP.
- 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 uma remoção surpresa do IRP.
Em todos esses casos, o driver do dispositivo deve desreferir a interface antes de passar o IRP para o motorista do ônibus.
InitializeInterface
Ponteiro para uma rotina fornecida pelo driver de ônibus 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 ele terminou de processar uma interrupção.
Observações
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 de bibliotecaSdBusOpenInterface para abrir uma interface.
Requisitos
| Requisito | Valor |
|---|---|
| cabeçalho | ntddsd.h |