enumerazione SDBUS_PROPERTY (ntddsd.h)

Articolo
02/07/2025

L'enumerazione SDBUS_PROPERTY elenca le proprietà di una scheda Secure Digital (SD) che un driver di dispositivo SD può impostare con una richiesta SD.

Sintassi

typedef enum {
  SDP_MEDIA_CHANGECOUNT,
  SDP_MEDIA_STATE,
  SDP_WRITE_PROTECTED,
  SDP_FUNCTION_NUMBER,
  SDP_FUNCTION_TYPE,
  SDP_BUS_DRIVER_VERSION,
  SDP_BUS_WIDTH,
  SDP_BUS_CLOCK,
  SDP_BUS_INTERFACE_CONTROL,
  SDP_HOST_BLOCK_LENGTH,
  SDP_FUNCTION_BLOCK_LENGTH,
  SDP_FN0_BLOCK_LENGTH,
  SDP_FUNCTION_INT_ENABLE,
  SDP_SET_CARD_INTERRUPT_FORWARD,
  SDP_SET_WAKE_INTERRUPT_FORWARD,
  SDP_HIGH_CAPACITY_SUPPORTED,
  SDP_CHAINED_MDL_SUPPORTED,
  SDP_HPI_SUPPORTED
} SDBUS_PROPERTY;

Costanti


`SDP_MEDIA_CHANGECOUNT` Indica che l'operazione si applica alla proprietà media change count. Questa proprietà include 4 byte di dati (ULONG) che descrivono le funzioni di archiviazione SD. Questa proprietà è di sola lettura.
`SDP_MEDIA_STATE` Indica che l'operazione si applica alla proprietà dello stato del supporto. Fornito per la compatibilità con i controller host di sola archiviazione SD. Valido solo per le funzioni di archiviazione SD. Per un elenco degli stati dei supporti validi, vedere SDPROP_MEDIA_STATE. Questa proprietà è di sola lettura.
`SDP_WRITE_PROTECTED` Indica che l'operazione si applica alla proprietà protetta da scrittura e allo stato dell'opzione WriteProtect sulla scheda SD. Questa proprietà è di sola lettura.
`SDP_FUNCTION_NUMBER` Indica che l'operazione si applica alla proprietà del numero di funzione. Questa proprietà è di sola lettura.
`SDP_FUNCTION_TYPE` SDBUS_FUNCTION_TYPE v2.0
`SDP_BUS_DRIVER_VERSION` Indica che l'operazione si applica alla proprietà della versione del driver. Questa proprietà è di sola lettura. Questa proprietà è supportata solo nella versione 2.0 o successiva del driver.
`SDP_BUS_WIDTH` Indica che l'operazione si applica alla proprietà larghezza del bus. Il valore di questa proprietà è 1 o 4. Questa proprietà è supportata solo nella versione 2.0 o successiva del driver.
`SDP_BUS_CLOCK` Indica che l'operazione si applica alla proprietà velocità dell'orologio del bus. Il valore di questa proprietà è in KHz. Questa proprietà è supportata solo nella versione 2.0 o successiva del driver.
`SDP_BUS_INTERFACE_CONTROL` Indica che l'operazione si applica alla proprietà del controllo dell'interfaccia del bus SDIO. Questa proprietà corrisponde a CCCR[7], definita nella specifica della scheda SDIO (Secure Digital I/O) . Per impostare la larghezza del bus, è necessario usare SDP_BUS_WIDTH per sincronizzare la funzione di memoria di una scheda combinata. Questa proprietà è supportata solo nella versione 2.0 o successiva del driver.
`SDP_HOST_BLOCK_LENGTH` Indica che l'operazione si applica alla proprietà lunghezza blocco host, ovvero la lunghezza massima del blocco supportata dal controller. Questa proprietà è di sola lettura. Questa proprietà è supportata solo nella versione 2.0 o successiva del driver.
`SDP_FUNCTION_BLOCK_LENGTH` Indica che l'operazione si applica alla proprietà della lunghezza del blocco di funzioni SDIO. Questa proprietà è supportata solo nella versione 2.0 o successiva del driver.
`SDP_FN0_BLOCK_LENGTH` Indica che l'operazione si applica alla proprietà lunghezza blocco zero della funzione SDIO. Questa proprietà è condivisa da tutte le funzioni della scheda SDIO. Questa proprietà è supportata solo nella versione 2.0 o successiva del driver.
`SDP_FUNCTION_INT_ENABLE` Indica che l'operazione si applica alla proprietà di attivazione dell'interrupt della funzione SDIO. Si tratta di una proprietà di tipo booleano e si applica solo alla funzione corrente. Questa proprietà è supportata solo nella versione 2.0 o successiva del driver.
`SDP_SET_CARD_INTERRUPT_FORWARD`
`SDP_SET_WAKE_INTERRUPT_FORWARD`
`SDP_HIGH_CAPACITY_SUPPORTED`
`SDP_CHAINED_MDL_SUPPORTED`
`SDP_HPI_SUPPORTED`

Osservazioni

Per leggere o impostare una proprietà in un dispositivo SD, un driver di dispositivo deve eseguire le operazioni seguenti:

Impostare il membro RequestFunction di SDBUS_REQUEST_PACKET su un valore di enumerazione SD_REQUEST_FUNCTION di SDRF_GET_PROPERTY o di SDRF_SET_PROPERTY.
Impostare il membro proprietà di SDBUS_REQUEST_PACKET sul valore di enumerazione SDBUS_PROPERTY che specifica la proprietà da leggere o modificare.
Inviare la richiesta al driver del bus passando la struttura di SDBUS_REQUEST_PACKET inizializzata a SdBusSubmitRequest o SdBusSubmitRequestAsync.

Fabbisogno

Requisito	Valore
intestazione	ntddsd.h (include Ntddsd.h)

Vedere anche

SDBUS_REQUEST_PACKET

SD_REQUEST_FUNCTION

SdBusSubmitRequest

SdBusSubmitRequestAsync

Condividi tramite