Função SdBusOpenInterface (ntddsd.h)

A rotina SdBusOpenInterface obtém uma interface do driver de barramento SD (Secure Digital).

Sintaxe

NTSTATUS SdBusOpenInterface(
  [in]  PDEVICE_OBJECT            Pdo,
  [out] PSDBUS_INTERFACE_STANDARD InterfaceStandard,
  [in]  USHORT                    Size,
  [in]  USHORT                    Version
);

Parâmetros

[in] Pdo

Ponteiro para o objeto de dispositivo físico que o driver de barramento SD criou para o dispositivo SD gerenciado pelo driver de dispositivo. O sistema passa esse ponteiro para o driver do dispositivo quando chama a rotina AddDevice do driver.

[out] InterfaceStandard

Contém, na entrada, um ponteiro para uma estrutura do tipo SDBUS_INTERFACE_STANDARD fornecida pelo chamador. Na saída, essa estrutura contém ponteiros para as rotinas da interface do barramento SD. Essa estrutura também contém algumas informações de contexto em seu membro contextual que o chamador deve passar sempre que chama uma rotina de interface.

[in] Size

Contém o tamanho, em bytes, da estrutura apontada por InterfaceStandard.

[in] Version

Deve ser definido como SDBUS_INTERFACE_VERSION.

Retornar valor

Retorna STATUS_SUCCESS se a operação for bem-sucedida ou o código de erro apropriado se a operação falhar.

Comentários

Um driver de cartão SD deve chamar essa rotina de sua rotina AddDevice.

Os motoristas do SD cartão devem chamar essa rotina para estabelecer a comunicação com o motorista do ônibus. Após a conclusão bem-sucedida dessa chamada, o membro Context da estrutura apontada por InterfaceStandard conterá um identificador que o driver deve passar ao chamar métodos que pertencem à interface recuperada.

Requisitos

Confira também

AddDevice

SDBUS_INTERFACE_STANDARD