IOCTL_KS_PROPERTY IOCTL (ks.h)

發行項
02/26/2024

應用程式可以使用IOCTL_KS_PROPERTY來取得或設定屬性，或判斷 KS 物件支援的屬性。應用程式會將IOCTL_KS_PROPERTY與以下所述的參數傳遞至 KsSynchronousDeviceControl 函式。

主要程序代碼

IRP_MJ_DEVICE_CONTROL

輸入緩衝區

用戶端指定 InBuffer 參數的內容取決於屬性要求，並記錄每個屬性集的內容。例如，要求 KSPROPSETID_Pin 屬性集中屬性的用戶端會指定 KSP_PIN 結構的指標。

輸入緩衝區長度

應用程式會將輸入緩衝區內容的大小以位元組為單位放在 InLength 參數中。

輸出緩衝區

同樣地，所需的輸出緩衝區類型也取決於屬性要求。

輸出緩衝區長度

應用程式會將輸出緩衝區的大小以位元組為單位放在 OutLength 參數中。

狀態區塊

如果要求成功，狀態成員會設定為 STATUS_SUCCESS。

備註

如需輸入和輸出緩衝區及其大小的詳細資訊，請參閱 KS 屬性。

篩選和釘選支援使用 IOCTL_KS_PROPERTY 裝置 I/O 控件的屬性集。雖然這個 IOCTL 是以 METHOD_NEITHER 旗標定義，但屬性數據會當做輸出緩衝區傳遞至 IOCTL 並探查以進行讀取存取。 KsPropertyHandler 函式會處理透過IOCTL_KS_PROPERTY要求的屬性。

如需有效旗標和對應描述的清單，請參閱 KSPROPERTY 結構的參考頁面。